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The  purpose  of  this  study  was  to  complete  the  development  of 
a  data  base  management  system  performance  monitor.  This 
study  presents  the  System  Requirements,  System  Analysis, 
System  Design  and  Implementation  of  a  data  base  management 
system  performance  monitor.  The  emphasis  of  this  study  is 
on  the  completion  of  the  performance  monitor  so  that  it  may 
be  applied  as  a  comprehensive  tool  for  the  analysis  of  DBMS 
performance  problems. 
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1.  Introduction 


Background 

A  Data  Base  Management  System  (DBMS)  is  a  complex  software 
tool  for  the  manipulation  and  maintenance  of  a  computer  data 
base.  The  benefits  of  using  a  DBMS  are  numerous  (7:9-12), 
but  come  at  the  expense  of  the  overhead  placed  on  computer 
resources.  It  is  natural  to  want  to  maximize  the  benefits 
and  minimize  the  overhead  incurred  by  the  use  of  a  DBMS. 

In  order  to  measure  and  identify  areas  where  reductions 
to  DBMS  over  lie  ad  can  be  made,  a  DBMS  performance  monitor 
called  DBMON  has  been  developed  (2;  5).  This  monitor  is  a 
much  needed  tool,  that  has  been  designed  to  free  Data  Base 
Administrators  (DBA)  from  having  to  rely  on  intuition,  and 
trial  and  error  techniques  for  improving  DBMS  performance. 

Performance  monitors  can  be  grouped  into  one  of  three 
categories  (16:82-108):  software,  hardware,  or  hybrid. 

This  study  concerns  itself  with  the  continued  development  of 
a  software  based  performance  monitor  with  special  emphasis 
on  DBMSs. 

The  thesis  "Development  of  a  Data  Base  Management 
System  Performance  Monitor"  documents  the  design  of  a  data 
base  performance  monitor  which  could  collect  and  display 
data  base  performance  information  (2).  Work  on  this 


performance  monitor  was  continued  in  "Continued  Development 
of  a  Data  Base  Management  System  Performance  Monitor"  ( 5 )  . 


»>  JV».  •jVtSVAA.f.j.Y.mVA.V.'-  V. . , 


a.  a-' 


This  second  thesis  effort  continued  development  of  the  DBA's 
interface  and  measurement  data  analysis  capability.  This 
interface  and  the  analysis  capability  allow  the  analysis  and 
evaluation  of  DBMS  performance. 

The  development  of  a  DBMS  performance  monitor  is  an 
objective  of  the  A  FIT  Information  Sciences  Laboratory  (ISL). 
DBMON  is  part  of  an  ongoing  research  development  of  a 
software  engineering  environment  that  will  include  DBMS 
applications  and  analysis. 

Problem 

The  situation  with  the  previously  developed  DBMS 
performance  monitor  (DBMON  Version  2.0)  is  that  it  was  an 
Incomplete  tool.  A  tool  that  lacked  a  complete  user's 
methodology.  A  systematic  approach  to  using  the  monitor  in 
solving  DBMS  performance  problems  was  required.  Another 
limitation  of  DBMON  was  that  its  interface  was  restricted  to 
use  on  the  TOTAL  DBMS.  An  extension  of  the  monitors 
capabilities  to  include  operation  with  other  DBMSs  was 
required  to  make  DBMON  useful  in  more  applications.  The 
third  area  that  was  lacking  with  the  previously  developed 
monitor,  was  the  need  to  complete  the  development  of  the 
user  interface  in  order  to  make  DBMON  a  more  complete, 
informative  and  easy  to  use  tool. 


Purpose 


The  purpose  of  this  study  is  threefold. 

1.  Develop  a  user's  methodology  for  the  application  of 
DBMON . 

2.  Adapt  DEMON  for  use  with  other  DBMSs. 

3.  Complete  development  of  the  user  interface. 

a.  Allow  for  the  graphical  representation  of  performace 
data. 

b.  Allow  for  statistical  analysis  of  performance  data. 

c.  Allow  for  DBMS  maintenance  of  historical  performace 
data. 

Scope 

The  primary  intention  of  this  study  was  to  complete  the 
development  of  DBMON.  The  study  does  not  provide  a 
comprehensive  analysis  of  all  possible  applications  of 
DBMON,  but  does  address  the  general  methodology  whereby 
DBMON  may  be  applied  to  the  analysis  of  performance 
p  rob lems . 

Assumpt ions 

1.  DBMON,  the  previously  developed  performance  monitor, 
is  assumed  to  function  correctly. 

2.  The  VAX  11/780  computer  system  and  its  VMS  operating 
are  assumed  to  operate  properly  and  provide  accurate  system 


resource  measurements. 

3.  The  TOTAL  and  any  other  DBMSs  used  will  remain 
operational  for  the  testing  of  the  performance  monitor. 

h  .  Any  graphical  and  statistical  packages  used  are 
assumed  to  work  properly. 

Standards 

AFIT/t'NC  standards  (1)  of  software  engineering  have  been 
adhered  to  in  the  requirement,  design,  implementation,  and 
testing  phases  of  the  project.  Structured  Analysis  and 
Design  Technique  (SADT)  Data  Diagrams  (15),  and  structure 
charts  were  used  in  order  to  provide  graphical  documentation 
of  the  design  process.  SADT  Data  Diagrams  are  an  effective 
method  of  documenting  the  functional  analysis  and  system 
design.  Structure  charts  are  used  to  clearly  document  the 
general  program  design.  Data  Dictionaries  are  used  in 
support  of  the  SADTs  and  Structure  Charts.  The  documentation 
used  follows  the  standards  established  by  AFIT/ENG  (1). 

Approach 

The  approach  used  in  this  project  consisted  of  the 


following  six  steps. 


Familiarization  with  the  existing  system  and  software: 

a.  VAX  11/780  computer  system 

b.  VMS  operating  system 
e.  TOTAL  and  1NGRLS  DBMSs 
d.  D  B  MON 

Literature  review  of  the  following  areas: 
a.  Graphical  and  statistical  evaluation  of  data 
b  .  DBMS  performance  evaluation 

System  design 

a.  Requirements  definition 

b.  Design  of  DBMON  expansion 

c.  Design  of  a  user's  performance  evaluation 
methodology 

d.  Define  test  objectives 

e  .  Document  design  process 

System  implmentation 
a.  Code  changes  and  additions  to  DBMON 
i).  Test  and  validate  the  implmentation 
.  [)  o  c  u  in  e  n  t  i  m  P  l  e mentation  and  testing  process 

■  -i  t  ••  m  analysis  and  testing 
V  i  1  i  I  a t  e  system 

'el  1  y / e  a  DBMS  performance  evaluation  methodology 


Documentat ion 


6  . 

a.  Compile  aiL  documentation 

b.  Apply  current  software  engineering  principles  and 
s  taudards 

Equipment  and  Software  Required 

This  study  required  the  use  of  the  VAX  11/780  computer 
that  is  located  in  the  A  F  I  T  Information  Sciences  Laboratory. 
All  the  required  software  was  residing  on  this  computer 
during  the  course  of  this  study.  The  software  includes  the 
VAX  VMS  operating  system,  VMS  utilities,  and  Data  Base 
Management  Systems. 

Sequence  of  Presentation 

Chapter  II  contains  the  functional  requirements  of 
DBM ON,  and  an  analysis  of  a  user's  data  base  performance 
evaluation  methodology.  Chapter  III  contains  the  system 
design  of  the  improvements  and  extensions  made  to  DEMON. 
Chapter  IV  documents  the  implementation  and  testing  of  DBMON 
on  the  VAX  11/780  computer  running  under  the  VMS  operating 
system.  Chapter  V  discusses  the  results,  conclusions,  and 
recommendations  of  this  study. 


Introduction 
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This  chapter  presents  the  system  analysis  and 
requirements  definition  for  the  parts  of  the  user  interface 
that  were  not  completed  by  the  previous  DEMON  development 
efforts  (2;5).  Specifically,  this  consists  of  the 
statistical  analysis  function,  the  graphical  presentation  of 
performance  data,  and  the  maintenance  of  historical 
performance  data.  This  chapter  also  considers  the 
requirements  of  expanding  DBMON  to  function  with  DBMSs  other 
than  TOTAL.  The  functional  requirements  of  the  expanded 
user  interface  are  presented  and  integrated  into  the 
previously  existing  (5)  requirements  of  a  DBMS  performance 
monitor.  In  addition,  a  DBMON  user's  methodology  is 
discussed. 

Background  on  the  DBMON  System 

DBMON  has  been  developed  at  AFIT/ENG  to  collect  and 
analyze  DBMS  performance  data  in  an  effort  to  understand  and 
improve  DBMS  performance.  DBMON  operates  by  using 
performance  measurement  and  collection  software  that  is 
embedded  into  DBMS  application  programs.  DBMON  allows  the 
user  to  establish  a  monitor  session,  during  which  computer 
system  statistics  are  recorded  and  DBMS  applications 
programs  are  executed.  The  embedded  DBMON  software  records 
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DBMS  performance  data  daring  the  execution  of  DBMS  Data 
Manipulation  Language  (DML)  statements  (7:21).  Once  the 
monitor  set-  ion  is  completed,  the  collected  data  is  analyzed 
and  can  be  veiwed  by  the  DBM ON  user.  This  monitor  system 
has  been  designed  and  implemented  on  the  VAX  11/780  computer 
at  the  A  F I T  Information  Sciences  Laboratory. 

The  structure  o£  DBMON  consists  o£  four  main  functional 
areas  as  shown  in  Figure  11-1.  The  four  functional  areas 
are: 

1.  User  Interface  -  This  section  allows  the  DBMON  user  to 
specify  performance  parameters  to  be  measured,  duration  of 
the  monitor  session,  and  types  of  data  presentation. 

2.  Measurement  of  System  and  DBMS  -  This  portion  of 
DBMON  controls  the  execution  of  the  monitor  program  and 
collects  performance  data. 

3.  Analyze  Performance  Measurement  Data  -  This  section  is 
to  perform  mathematical  and  statistical  analysis  of 
performance  data. 

A.  Present  Performance  Data  to  the  User  -  This  section 
presents  the  collected  and  analyzed  performance  data  to 


the  DBMON  user. 
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This  study  addresses  enhancements  to  aLl  four  DU  MON 


function nl  areas.  Areas  one  and  two  are  affected  by  the 
adaption  of  DU  MON  to  function  with  more  than  one  DtiMS.  Area 
three  is  concerned  with  the  statistical  and  graphical 
analysis  of  performance  data.  Graphical  and  historical  data 
presentation  are  a  portion  of  area  four. 


Adapt  ion  of  DBMON  to  Other  DBMSs 

The  usefulness  of  any  tool  can  be  maximized  when  it  can 
be  applied  to  a  wide  variety  of  applications.  Therefore  the 
rationale  of  expanding  DUMON  to  work  with  other  DUMSs  is  to 
make  DUMON  a  more  useful  tool  by  expanding  its 
applicability. 

The  functional  requirements  of  DDMS  performance 
measurement  can  be  directly  applied  from  previous  work  (2) 
with  the  TOTAL  DBMS.  Chapter  II  of  the  thesis  "Deve lopment 
of  a  DBMS  Performance  Monitor"  (2)  extensively  discusses  the 
initial  requirements  and  system  analysis  of  the  measurement 
of  a  DBMS. 

Briefly,  the  measurement  of  a  DDMS  includes  the 
consideration  of  performance  parameters  that  reflect  upon 
the  effectiveness  and  efficiency  of  the  DBMS.  This  involves 
the  measurement  of  the  host  computer's  workload  and  the 
effect  of  DBMS  operations  upon  the  host  computer.  Appendix 
C  of  tlie  above  mentioned  thesis  contains  a  comprehensive  set 
of  DBMS  performance  measurement  parameters. 

11-4 


Developing  a  unified  DBMS  performance  monitor  can  be 


accomplished  by  directly  applying  the  functional 
requirements  and  system  design  from  the  previously  developed 
DBM ON.  Maintaining  one  set  of  requirements  for  all  the 
DBMSs  that  DBMON  can  be  used  with,  minimizes  the  amount  of 
special  case  processing  that  is  required  by  a  DBMON  user  who 
applies  this  tool  to  TOTAL  and  other  DBMSs.  It  is  possible, 
however,  that  some  unique  features  of  a  particular  DBMS  will 
not  be  able  to  be  measured  directly  or  easily  because  of  the 
use  of  a  more  general  data  base  performance  monitor. 

However,  the  advantage  of  using  a  more  general  and  widely 
applicable  tool  outweigh  any  occasional  inconvenience. 

Statistical  Analysis  of  DBMS  Performance  Data 

The  need  for  statistical  analysis  (data  reduction)  of 
DBMS  performance  data  becomes  apparent  when  one  is 
confronted  by  a  mass  of  performance  data.  The  requirement 
here  is  to  analyze  the  data  and  reach  a  conclusion  as  to  the 
data's  significance.  The  obvious  solution  of  the  data 
analysis  problem  is  to  apply  statistical  techniques  in  order 
to  be  able  to  make  an  inference  as  to  the  significance  of 
performance  testing.  Statistical  data  reduction  can  bring 
the  mass  of  performance  data  into  a  manageable  form. 

A  difficulty  arises  at  this  point  in  deciding  what 
quantatative  methodology  should  be  applied  in  order  to 
evaluate  DBMS  performance.  Quantitative  methods  can  be 
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A  problem  that  arises  is  the  very  large  number  of 
factors  and  their  complex  interrelationships.  Even  worse 
are  factors  that  affect  the  experimentation  but  cannot  be 
effectively  controlled.  An  instance  is  the  effect  of  a 
computer's  workload  during  the  time  of  testing.  Any 
experimental  design  should  concern  itself  with  extraneous 
factors  like  system  workload. 

The  factorial  experiment  is  most  useful  in  the  computer 
performance  environment  (13:18).  This  type  of  performance 
testing  evaluates  all  combinations  of  the  factors  under 
study  in  an  effort  to  uncover  the  interactions  between  the 
factors.  Analysis  of  variance  is  a  technique  that  can  be 
very  useful  in  evaluating  statistical  data.  This  technique 
will  allow  use  i  mat  ion  of  the  effects  and  determine  which  of 
the  effects  that  were  measured  are  important. 

If  a  factorial  statistical  test  is  not  available, 
pairwise  comparisons  of  two  groups  of  sample  data  can  be 
done.  If  more  than  one  factor  is  being  considered,  then 
multiple  pairwise  comparisons  can  be  used  to  detect  which 
factor  or  combination  of  factors  has  a  significant  effect. 

Tli  is  technique  can  circumvent  the  unavailability  of  a  fully 
factorial  statistical  test. 

The  statistical  processing  module  of  DBM ON  needs  to 
take  the  collected  performance  data  and  perform  user 
requested  statistical  calculations  that  will  indicate  the 


presence  or  absence  of  any  statistical  difference  between 
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DBMS  performance  measurement  data  sets.  The  results  of  the 
statistical  analysis  need  to  be  displayed  on  the  video 
terminal  and/or  printed  on  the  system  printer  In  order  to  be 
evaluated  by  the  DBMON  user. 

Graphical  Pres  entatlon  of  Performance  Data 

Graphical  presentation  of  a  large  amount  of  numerical 
data  is  the  simplest  method  of  portraying  a  trend  within  a 
large  body  of  data.  DBMON  is  capable  of  producing  a  vast 
amount  of  raw  numerical  data  that  cannot  be  evaluated  by 
simply  scanning  the  numbers.  An  obvious  solution  is  to 
convert  the  raw  performance  data  into  graphical 
presentations  showing  the  distribution  of  the  performance 
parameter  that  is  being  examined. 

There  are  six  general  methods  of  representing 
performance  data  to  the  DBMON  user  (5:11-10). 

1.  Lists  -  lists  of  performance  data. 

2.  Graphs  -  graphical  information  display. 

3.  Tables  -  organized  lists  with  headings  and  totals. 

A.  Plots  -  plotted  performance  data. 

5.  Charts  -  Gantt  charts,  pie  charts,  and  histograms. 

6.  Reports  -  custom  made  reports  of  DBMS  performance 

data. 
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DBMON  already  has  implemented  the  use  of  Lists,  tables,  and 
custom  reports.  What  is  required  to  further  improve  the 
presentation  of  performance  data  to  the  user  is  the  use  of 
graphs  and  charts.  This  will  allow  the  quick  interpretation 
of  general  trends  that  is  not  possible  by  examining  the 
reports  of  numerical  data.  The  "simplest"  method  applicable 
here  is  the  use  of  the  histogram.  Histograms  are  easily 
constructed  and  meet  the  requirement  of  presenting  data 
trends.  Plots  may  be  used,  but  they  are  more  complex  than 
histograms . 

The  DBMON  graphical  presentation  module  should  allow 
the  display  of  any  of  the  performance  measures  that  are 
collected  by  DBMON.  For  maximum  utility  the  graphical 
presentation  should  displayed  at  the  video  terminal  and  at 
the  system  printer  at  the  request  of  the  DBMON  user. 

Historical  Maintenance  of  Performance  Data 

Over  a  long  period  of  time  a  large  amount  of  DBMS 
performance  data  can  be  collected.  What  is  needed  is  a 
method  of  maintaining  an  index  of  performance  tests  that 
will  allow  the  maintenance  of  benchmark  evaluations. 
Maintaining  benchmarks  is  required  for  the  testing  of 
differ n ces  due  to  a  change  in  DBMS  processing  over  a  period 
of  time. 

In  essence,  what  is  required  is  a  library  management 
system  that  uses  a  DBMS  fr  maintaining  a  library  of 
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performance  test  data.  The  user  needs  to  be  able  to  store 
performance  reports  into  a  library  and  retrieve  the  data 
when  needed.  The  performance  data  could  be  identified  by 
the  collection  date,  or  some  other  means  of  identification. 
This  library  of  benchmarks  can  be  used  as  needed  as 
references  to  previous  performance  states  of  the  DBMS  being 
studied.  For  further  discussion  of  DBMS  performance 
benchmarks  see  reference  4. 

Analysis  of  a  DBMS  Performance  Methodology 

Methodology  can  be  defined  as  the  synthesis  of  methods 
and  tools.  The  Tool  in  the  case  of  this  study  is  the  DBM ON 
system.  DBM ON  and  the  methods  of  its  application  comprise  a 
DBMON  user's  methodolgy  as  shown  in  Figure  11—2  (A  similar 
performance  improvement  procedure  is  discussed  in  reference 
(3)  ).  A  method  for  analyzing  DBMS  performance  can  consist 

of  the  following  five  phases: 

1.  Understand  the  System  -  This  phase  involves 
familiarization  with  the  computer  system,  the  DBMS,  and 
the  DBMS  application  being  studied. 

2.  Identify  Problem  Areas  -  This  phase  involves  analyzing 
the  use  of  a  DBMS  to  identify  any  potential  problem  areas 
that  need  to  be  addressed.  This  phase  could  also  involve 
making  and  storing  benchmark  measurements  against  which  to 
guagc  any  future  performance  degredations. 
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3.  Formulate  a  Performance  Improvement  Hypothesis  -  Once 
familiar  with  the  system,  and  having  identified  a  problem 
area,  possible  performance  improvement  hypothsis  can  be 
listed.  These  hypothesis  should  be  analyzed  to  see  if 
they  are  feasible.  Unrealistic  solutions  to  performace 
problems  can  be  rejected  at  this  stage. 

4  .  Test  Performance  Improvements  -  This  stage  involves 
the  design,  implementation,  and  analysis  of  an  experiment. 
The  hypothesis  from  phase  four  can  be  implemented  and 
statistically  evaluated  against  the  benchmark  testing  from 
phase  two. 

5.  Implement  Performance  Improvement  Modifications  -  The 
statistical  evaluation  of  phase  four  should  indicate  the 
most  effective  modifications  that  can  be  made.  In  this 
phase,  tlie  modifications  should  be  installed  and  validated 
for  effectiveness  and  efficiency. 


The  DBMON  User's  Methodolgy  is  further  described  in  Appendix 
E,  the  DBMON  User's  Guide.  The  User's  Guide  discusses  the 
practical  application  of  the  DBMON  User's  Methodology  to 
solving  DBMS  performance  problems  with  the  DBMON  performance 
monitor. 
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Suronia  r  y 


This  chapter  presented  the  general  system  analysis  and 
functional  requirements  for  the  D3M0N  DBMS  performance 
monitor.  The  following  components  of  DBMON  development 
completion  were  discussed: 

1.  DBMON  adaption  to  DBMSs  other  than  TOTAL 

2.  Statistical  analysis  of  performance  data 

3.  Graphical  presentation  of  performance  data 

4.  Maintenance  of  historical  performance  data 

Functional  requirements  of  the  above  components  were  listed 
and  incorporated  into  the  general  requirements  of  DBMON. 

The  current  set  of  detailed  functional  requirements  for  the 
DBMON  system  are  presented  in  Appendix  A. 

This  chapter  also  discussed  a  DBMON  User's  Methodology. 
This  methodology  was  presented  as  an  application  of  DBMON  to 
solving  DBMS  performance  problems. 
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Introduction 


This  chapter  presents  the  system  design  for  the 
continuing  development  of  DBMON.  The  revised  functional 
requirements  discussed  in  chapter  II  were  used  as  objectives 
of  the  system  design,  and  are  addressed  in  the  revised 
d  e  s  i  g  n  . 

This  chapter  addresses  the  system  design  documentation, 
descriptions  of  the  design,  and  the  test  plan  to  be  used  in 
the  implementation  stage  of  development. 

Design  Documentation 

The  Structured  Analysis  and  Design  Technique  (SADT) 

(15)  was  used  to  document  the  revised  design  of  a  DBMS 
performance  monitor.  The  SADT  technique  was  primarily  used 
because  it  specifically  shows  the  activities  that  the  design 
must  address.  The  use  of  SADTs  is  also  in  keeping  with  the 
previous  two  DBMON  development  efforts  (2;5).  Reference  15 
may  be  consulted  for  the  details  of  the  use  and 
interpretation  of  SADTs.  The  SADT  documentation  technique 
is  also  consistent  with  the  documentation  standards  of 
AFIT/ ENG  ( 1 ) . 

This  chapter  addresses  the  additions  and  changes  made 
to  the  previously  existing  design  of  a  data  base  performance 
monitor.  The  complete  set  of  SADT  documentation  for  the 
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data  base  performance  monitor  is  contained  in  Appendix  B  . 
This  set  contains  the  entire  system  design  developed  in 
previous  work  (2;5)  a  long  with  the  additions  and  changes 
made  during  the  course  of  this  study.  Appendix  C  contains 
changes  to  the  system  test  plan.  Appendix  D  contains  the 
system  design  structure  charts  of  the  portions  of  the  data 
base  performance  monitor  that  were  modified  during  the 
course  of  this  study. 


Overall  System  Design  Summary 

The  top  level  view  of  the  DBM ON  system  was  presented  i 
Chapter  II  and  illustrated  by  Figure  1 1  - 1  .  Chapter  III  of 
references  2  and  5  also  discuss  the  overall  system  design. 

•  As  seen  in  Figure  1 1  —  1 ,  the  data  base  performance 

v.. 

monitor  can  be  separated  into  four  functional  areas.  These 
functional  areas  are: 


(1)  User  Interface 

(2)  Measure  System  and  DBMS 

(3)  Analyze  Measurement  Data  Files 

(4)  Present  Performance  Measurement  Data  to  User 


The  User  Interface  (see  Figure  B-3)  controls  the 
operation  of  the  performance  monitor.  It  allows  the  DB MON 
user  to  specify  monitor  options,  initiate  monitor  operation 
and  terminate  monitor  execution.  The  user  interface  uses 
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the  monitor  user's  directives  to  build  a  set  of  performance 
commands  used  to  perform  the  DBMS  and  system  measurement, 
analyze  the  raw  data,  and  display  the  analyzed  measurement 
data  to  the  user. 

The  Measure  System  and  DBMS  functional  area  (see  Figure 
B-4)  performs  the  actual  system  and  DBMS  measurements  as 
directed  by  commands  from  the  User  Interface.  The  Map 
Performance  Parameters  to  Measurement  Source  activity 
relates  the  user  requested  measurement  to  the  available 
performance  tools.  The  Create  Performance  Tool  Commands  or 
Instructions  activity  creates  the  performance  tool 
instructions  used  to  control  performance  tool  operation. 

The  Create  or  Initialize  Measurement  Data  Files  activity 
creates  new  data  files  or  initializes  existing  files  that 
will  be  used  to  record  performance  data.  The  Activate 
Performance  Tools  activity  uses  the  tool  commands  to 
activate  and  control  the  tool  operation.  The  Connect 
Performance  Tool  activity  uses  tool  instructions  to  direct 
human  operation  of  any  performance  tools  that  require 
operator  intervention. 

The  Analyze  Measurement  Data  Files  activity  (see  Figure 
B-5)  combines  the  measurement  data  files  produced  by  the 
various  performance  tools  into  one  measurement  data  file 
that  is  formatted  for  presentation  to  the  user.  This 
activity  is  controlled  by  user  commands  obtained  by  the  User 
Interface.  The  Perform  Statistical  and  Graphical  Analysis 


VV 


activity  takes  the  raw  measurement  data  files  and  prepares 
the  data  for  statistical  and/or  graphical  analysis.  The 
statistical  and  graphical  analysis  can  be  performed  by  a 
statistical/graphical  analysis  package  that  provides  the 
requested  analyzed  data  to  the  monitor  user. 

The  Present  Performance  Measurement  Data  to  User  area 
(see  Figure  B-6)  presents  the  analyzed  performance  data  to 
the  monitor  user.  The  Create  Performance  Parameter  Report 
creates  the  performance  parameter  report  from  the  analyzed 
measurement  data  files.  The  Perform  Library  Management 
activity  allows  monitor  performance  reports  to  be  stored  in 
a  library  until  deleted  by  the  user.  The  Present 
Performance  Data  to  User  activity  displays  the  analyzed 
measurement  data,  statistical  analysis,  and  graphical 
representation  of  performance  data  upon  the  terminal  screen. 


Adaption  of  DEMON  to  Use  with  Other  DBMSs 

The  initial  flexible  design  of  DBM ON  allows  for  the  use 
of  any  DBMS  with  DBMON,  so  the  system  design  changes  only 
slightly  with  regard  to  the  use  of  another  DBMS.  Adapting 
another  DBMS  to  work  with  DBMON  is  primarily  a  matter  of 
implementation.  Figure  B  -  4  shows  the  Measure  System  and 
DBMS  SADT  Activity  Diagram.  It  is  unchanged  from  the 
previous  system  design  (5).  Figure  D-7  shows  the  structure 
chart  of  the  Instrumentation  Utility.  In  order  to 
accomodate  more  than  one  DBMS,  the  utility  is  now  passed 
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the  name  of  t  h e  DBMS  that  is  to  be  measured.  This  allows 
the  utility  to  perform  any  special  processing  required  for 
the  measured  DBMS. 


Design  of  the  Statistical  Analysis  Function 

The  requirements  of  statistical  analysis  had  been 
initially  addressed  in  previous  DBMON  development  efforts 
(2;5).  The  S  A  D  T  activity  diagram  is  represented  in  Figure 
111-1.  Structure  charts  are  represented  in  Figures  D-4  and 
D-8 .  Statistical  analysis  is  a  part  of  the  analysis  process 
that  converts  the  raw  performance  data  collected  by  the 
monitor  into  a  more  useable  form.  Measurement  Data  Files 
and  Analyzed  Measurement  Data  Files  are  formatted  into 
statistical  analysis  data  that  is  analyzed  under  the  user 
direction  in  the  Data  Analysis  Program. 

The  statistical  analysis  data  is  stored  in  a  data  file 
structure.  A  data  file  structure  is  sufficient  to  store 
statistical  information  for  later  sequential  retrieval. 
Additional  data  retrieval  operations  provided  by  other  data 
structures,  such  as  linked  lists,  are  not  required  for  the 
statistical  analysis  process.  Each  record  in  this  file 
includes  the  following  information: 


(a)  DBMS  DML  command  identifier 

(b)  DHL  performance  data  items 
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The  outputs  of  this  activity  are  statistical  analysis 


displays  that  can  be  presented  to  the  monitor  user.  The 
Perform  S t a t i s t i c a  1 / Gr a ph i c a  1  Analysis  Activity  satisfies 
functional  requirement  3.2  in  Appendix  A. 

Design  of  the  Graphical  Analysis  Function 

Graphical  Analysis  is  a  part  of  the  Perform 
S t a t i s t i c a  1/ G r aph ic a  1  Analysis  Activity  shown  in  Figure 
II1-1.  Structure  charts  are  represented  in  Figures  D-5  and 
D-8 .  Graphical  analysis  design  is  conceptually  closely 
related  to  the  statistical  analysis.  The  data  required  for 
both  types  of  analysis  are  the  same,  and  the  software 
packages  needed  to  implement  the  analysis  will  relate 
operationally  to  the  DBMON  design  in  similar  ways. 
Measurement  Data  Files  and  Analyzed  Measurement  Data  Files 
are  formatted  into  graphical  analysis  files  which  are 
analyzed  under  the  direction  of  Analysis  Commands  from  the 
User  Interface. 

The  graphical  analysis  data  is  stored  in  a  data  file 
structure.  As  with  the  statistical  analysis  data  structure 
a  file  structure  is  sufficient  to  store  statistical 
information  for  later  sequential  retrieval.  Each  record  in 
this  file  includes  the  following  information: 
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(a)  DBMS  DML  command  identifier 

(b)  DML  performance  data  items 

The  outputs  of  this  activity  are  graphical  analysis 
displays  that  can  be  presented  to  the  monitor  user.  The 
Perform  S t a t  i  s t i c a  1 / G r a p h i c a  1  Analysis  Activity  satisfies 
functional  requirement  3.2  in  Appendix  A. 

Design  of  Performance  Report  Library  Function 

Figure  III-2  shows  the  SADT  activity  diagram  for  the 
Perform  Library  Management  Activity.  Structure  charts  are 
represented  in  Figure  D-6.  The  design  addresses  the  need  of 
storing,  retrieving,  and  deleting  performance  reports  from  a 
library.  The  Performance  Parameter  Report  is  input  into  the 
report  library  by  the  Store  Report  activity.  Once  stored,  a 
report  can  be  retrieved  by  the  Retrieve  Report  activity  for 
viewing  or  deleted  when  no  longer  required  by  the  Delete 
Report  activity. 

This  activity  uses  a  file  structure  to  store  the  index 
to  the  Report  Library.  Each  record  in  this  file  contains 
the  following  information: 

(a)  Performance  report  identifier 

(b)  Report  library  file  name 
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The  Report  Library  uses  this  information  to  maintain  an 
index  to  the  contents  of  the  library. 

The  Perform  Library  Management  activity  satisfies 
functional  requirement  4.4  in  Appendix  A. 

Test  Plan 

A  formal  test  plan  for  the  DBMS  performance  monitor  has 
been  developed  and  can  be  found  in  Appendix  D  (2).  Each 
entry  contains  the  functional  requirement,  specific  test 
cases,  expected  results  of  the  test  cases,  actual  results, 
and  a  remarks  section.  This  format  is  the  same  as  used  in 
reference  (2).  During  this  study  several  changes  and 
additions  were  made  to  the  functional  requirements  and 
system  design.  The  additions  and  changes  to  the  previously 
existing  test  plan  (2)  are  contained  in  Appendix  C. 

Summary 

This  chapter  presented  the  system  design  for  the 
changes  made  to  DBMON.  The  chapter  discussed  design 
documentation,  overall  system  design,  a  description  of 
changes  to  the  previous  design,  and  the  changes  to  the 
previous  DBMS  performance  monitor  test  plan.  The  SADT 
design  documentation  is  contained  in  Appendix  B.  The 
additions  to  the  performance  monitor  test  plan  are  contained 
in  Appendix  C.  Appendix  D  contains  the  structure  charts  for 
the  system  design  changes. 
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IV .  System  Implementation  and  Testing 

Introduction 

This  chapter  presents  the  implementation  and  testing  of 
DBMON  extensions.  The  chapter  includes  the  implementation 
plan,  DBMS  and  programming  language  selection,  development 
computer  configuration,  discussion  of  DBMON  extensions,  and 
general  DBMON  operation  description.  Appendix  E  contains 
the  detailed  DBMON  User's  Guide.  Appendix  F  contains  the 
test  results. 

Implementation  Plan 

The  implementation  of  DBMON  modifications  discussed  in 
chapters  11  and  III  were  undertaken  with  the  following 
steps  : 

1.  Understand  the  VAX  11/780  computer  system  and  VAX/VMS 
operating  system. 

2.  Understand  the  use  and  operation  of  the  previously 
existing  version  of  DBMON. 

3.  Understand  the  use  and  operation  of  the  INGRES  DBMS. 

4.  Modify  the  Instrumentation  Utility  to  allow  the  INGRES 
DBMS  to  be  measured.  Document  the  modifications  with 
structure  charts  and  commented  code.  This  step  relates  to 
functional  requirement  2.1. 

5.  Modify  the  Data  Analysis  Program  to  allow  it  to 


function  with  INGRES  performance  measurement  data. 


Document  the  modifications  with  structure  charts  and 
commented  code.  This  step  relates  to  functional 
requirement  3.1.  1. 

6.  Modify  the  Data  Analysis  program  to  allow  it  to 
produce  statistical  and  graphical  data  files.  Document 
the  modifications  with  structure  charts  and  commented 
code.  This  step  relates  to  functional  requirements  3.0. 

7  .  Modify  the  DBM ON  program  to  allow  graphical  display  of 
performance  measurement  data.  Document  the  modifications 
with  structure  charts  and  commented  code.  This  step 
relates  to  functional  requirement  4.3. 

8.  Modify  the  DBM ON  program  to  allow  statistical  analysis 
to  be  performed  and  displayed.  Document  the  modifications 
with  structure  charts  and  commented  code.  This  step 
relates  to  functional  requirement  3.2. 

9.  Modify  the  DBM ON  program  menus  to  include  an  online 
help  feature  to  display  information  about  DBMON  menus. 
Document  the  modifications  with  commented  code.  This  step 
relates  to  functional  requirement  5.0. 


Development  Computer  Configuration 

DBMON  has  been  implemented  on  the  Digital  Equipment 
Corporation  (DEC)  VAX  11/780  (10)  located  in  the  AP1T/EN 
Information  Sciences  Laboratory.  This  computer  system  is 
primarily  used  to  conduct  research,  but  is  also  used  in 
limited  classroom  support.  A  representation  of  the  hardware 
configuration  is  shown  in  Figure  I V  —  1  . 
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Selection  of  DBMS  and  Programming  Language 

DBM ON's  interface  to  the  INGRES  DBMS  (14)  was 
implemented  during  the  course  of  this  study.  INGRES  was 
selected  for  two  major  reasons.  First,  it  was  readily 
availible  for  use  on  the  ISL  VAX  11/780  computer  system. 
Second,  by  being  a  relational  DBMS,  INGRES  provides  an 
interesting  contrast  to  the  TOTAL  (6)  DBMS,  a  network  type 
DBMS,  that  was  previously  interfaced  with  DBMON.  An 
alternative  was  DEC's  Datatrieve  (9).  Datatrieve,  however, 
is  another  network  type  DBMS.  The  contrast  with  TOTAL  would 
not  have  been  as  great  as  the  contrast  with  INGRES. 

The  programming  language  selected  for  implementation 
was  VAX/VMS  Pascal  (11).  The  rationale  was  simply  to  remain 
consistent  with  the  previous  versions  of  DBMON.  It  would  be 
an  unreasonable  complication  to  use  another  programming 
language  for  the  modifications  to  DBMON,  and  a  duplication 
of  effort  to  rewrite  the  entire  system  in  another  language. 

The  instrumentation  utility  is  the  only  portion  of  the 
DBMON  system  not  written  in  Pascal.  This  utility  is  written 
in  VAX  Macro  Assembly  Language  (12).  This  utility  was 
originally  written  in  Macro  because  of  Pascal's  limited 
ability  to  interact  with  the  VAX  File  System  and  System 
Services  Library  (2:V-6).  For  the  same  reasons  as  the 
Pascal  language  selection,  the  use  of  Macro  Aserably  Language 


was  maintained  for  the  Instrumentation  Utility. 


Several,  changes  were  made  to  the  previously  existing 
version  of  DBMON  (5)  in  order  to  allow  the  monitoring  of  the 
INGRES  DBMS.  The  Instrument  Utility  was  changed  so  that  it 
could  measure  either  TOTAL  or  INGRES  operation  (see  Figure 
D-7).  This  was  needed  in  order  to  interface  INGRES  to 
DBMON.  The  DBMS  application  program  that  calls  the 
Instrument  Utility  now  passes  the  name  of  the  DBMS  that  is 
being  accessed.  The  Instrument  Utility  uses  this 
information  to  identify  the  target  DBMS  running  on  the 
computer  system  and  perform  system  measurements  accordingly. 
There  was  no  change  from  the  previous  versions  of  DBMON 
(2;5)  in  the  type  of  data  collected  or  the  system  tools  used 
to  collect  the  data.  The  previously  defined  measurement 
parameters  were  applied  directly  to  the  instrumentation  of 
INGRES. 

Another  change  performed  to  interface  INGRES  to  DBMON 
was  to  the  Data  Analysis  Program  that  analyzes  the  raw 
measurement  data  and  produces  the  instrumentation  report 
(see  Figure  D-8).  Upon  running  this  program,  the  user  now 
specifies  the  name  of  the  DBMS  that  produced  the  raw 
measurement  data.  Since  TOTAL  and  INGRES  use  different  DML 
commands,  the  Data  Analysis  Program  must  be  directed  as  to 
which  set  of  DML  commands  it  is  to  work  with  in  producing 
the  instrumentation  report. 
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Software  Imp lmenta t ion  of  the  Report  Library  System 

The  Report  Library  was  implemented  as  part  of  the  DB MON 
User  Interface  Program.  The  User  Interface  Program  already 
was  able  to  display  the  current  performance  report;  now  the 
library  allows  historical  performance  reports  to  be 
maintained  and  retrieved  when  needed.  The  Report  Library 
Block  Diagram  for  the  library  is  shown  in  Figure  IV-2  .  The 
Library  is  reached  by  the  user  through  the  use  of  menu 
directed  commands,  for  details  of  operation  see  Appendix  E. 

The  Report  Library  consists  of  two  parts:  an  INGRES 
data  base  of  information  about  stored  reports,  and  a  VMS 
sub -d i r e c t o r y  of  the  actual  report  files.  The  function  of 
the  INGRES  data  base  is  to  record  a  descriptive  title  and 
the  date  of  each  stored  report.  By  entering  this 
information  along  with  the  file  name  of  the  report  to  be 
stored,  the  DBMOM  user  can  direct  the  Library  to  copy  the 
report  file  into  the  report  s ub -d i r e c t o r y  .  The  report 
s ub -d i r e c t o r y  is  the  actual  repository  of  performance 
reports.  Once  the  reports  are  stored,  the  user  can  then 
identify  them  uniquely  by  specifying  the  title  and  date, 
thereby  allowing  retrievals  of  stored  reports,  and  the 
deletion  of  unwanted  reports.  A  listing  of  the  library 
contents  may  "easily"  be  obtained  by  interactively  directing 
INGRES  to  list  the  library  data  base  contents.  This  listing 
is  also  available  for  viewing  in  the  DBMON  Interface 
Program. 
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The  alternative  to  this  Report  Library  was  to  manually 


maintain  a  library  of  performance  reports.  The  major 


benefit  of  the  automated  library  is  the  automatically 


enforced  recordkeeping  that  will  keep  reports  from  being 


misplaced  or  forgotten.  A  minor  benefit  is  the  ease  of 


itorage,  retrieval,  and  deletion  of  reports. 


Software  Imp  lme n t a t i on  of  the  Graphical  Measurement  Data 


The  implementation  of  the  graphical  measurement  display 


began  with  a  modification  of  the  Data  Analysis  Program. 


This  program  was  made  to  produce  an  INGRES  data  base  of  the 


performance  measurement  data  formatted  to  allow  simple 


conversion  into  a  bar  graph  display  on  the  user's  terminal 


(See  Figure  D-8).  The  relations  of  the  data  base  are  the 


following 


(1)  DBMS  DML  command  identifier 


(2)  DBMS  performance  parameter  value 


(3)  Column  position  of  the  data  value  in  the  display 


graph 


The  use  of  INGRES  also  allows  easy  adaption  of  the  graphical 


analysis  files  for  use  with  any  future  extension  of  DBMON 


graphical  capability. 
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The  graphical  analysis  is  carried  out  in  the  DBMON  User 
Interface  Program  as  an  extension  of  the  existing  capability 


to  display  performance  measurements.  This  program  uses 
VT100  terminal  graphics  to  produce  graphical  performance 
data  representations  since  VT100  terminals  and  VT1QQ 
compatible  terminals  (VT240)  are  available  in  the  AFIT  ISL. 
Other  terminal  types  may  be  used  after  some  modification  to 
the  DBMON  graphics  software  modules  (See  Appendix  E).  The 
Block  Diagram  for  the  graphical  analysis  of  performance  data 
is  presented  in  Figure  IV-3. 

The  performance  graphics  produce  a  bar  graph  showing 
the  relative  frequency  of  the  following  instrumentation 
parameters  broken  into  eight  equally  sized  ranges  of  values. 


( 1) 
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Eight  graph  partitions  were  chosen  as  a  compromise  between 
screen  readability  and  maximum  spread  of  the  performance 
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There  are  many  alternatives  to  using  a  bar  graph  to 
represent  performance  data  such  as  pie  charts  and  scatter 
plots.  Bar  graphs  were  selected  because  of  their  greater 
simplicity,  ease  of  understanding,  and  ease  of 
implementation.  The  latter  was  important  in  the  case  of 
this  study  due  to  the  unavailibiiity  of  a  suitable  graphical 
analysis  package.  Bar  graphs  satisfy  the  requirement  of 
graphically  portraying  performance  data  in  a  way  that  can 
help  identify  trends  in  the  data. 

Software  Imp lme n t a t i on  of  the  Statistical  Analysis  of 
Performance  Data 

The  Data  Analysis  Program  that  produces  the  graphical 
analysis  files  also  produces  the  statistical  analysis  files. 
To  produce  a  statistical  analysis  file  the  OB  MON  user  must 
specify  a  name  for  the  statistical  file.  This  name  will  be 
required  by  the  DBMON  User  Interface  program  in  order  to 
identify  the  correct  statistical  files  that  are  to  be 
compared.  The  statistical  analysis  file  is  also  an  INGRES 
data  base.  The  relations  of  the  data  base  are  the 
following: 

(1)  DBMS  DML  command  identifier 

(2)  DBMS  performance  parameter  values 
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The  use  of  INGRES  simplifies  any  future  extension  of  DBM ON 
statistical  capabilities.  The  Block  Diagram  for  the 
statistical  analysis  function  Is  presented  in  Figure  I V  -  4  . 

The  DBMON  User  Interface  takes  the  user  specified 
statistical  analysis  flies  and  conducts  the  Wilcoxon 
Rank-Sum  Test  (  8:582  ).  This  nonp  a  r  aine  t  r  1  c  test  determines 
If  there  is  any  statistical  difference  between  the  two 
specified  statistical  analysis  flies.  The  results  of  the 
analysis  are  presented  to  the  user  upon  the  terminal  screen. 

A  non  pa rame t r 1 c  test  was  implemented  because  of  its 
distribution -free  nature.  The  use  of  a  parametric  test 
would  have  involved  an  assumption  that  the  performance  data 
is  normally  distributed.  Since  DBMON  collected  sample  sizes 
may  be  small,  it  may  be  unreasonable  to  make  an  assumption 
of  normality  in  the  distribution  of  performance  data.  In 
the  case  of  DEMON  collected  data,  the  distribution  is  not 
known  in  advance,  and  a  nonparametric  statistical  test  is 
preferred.  The  Wilcoxon  Rank-Sum  test  is  approximately  95% 
as  efficient  as  the  parametric  t  test  when  the  actual 
distribution  is  normal  (3:536).  When  the  underlying 
distrlliution  of  performance  data  is  not  normal,  the  Wilcoxon 
Rank-Sum  Test  can  be  several  times  as  efficient  as  the  t 
test. 
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An  alternative  to  the  Wilcoxon  Rank-Sum  Test  is  a 


d i s t r i bu t i on - f re e  Analysis  of  Variance  (  8  :595).  This  ANOVA 
is  more  complicated  than  the  Rank-Sum  Test  but  does  allow 
the  use  of  one  statistical  procedure  to  analyze  the  affect 
of  several  performance  changes  and  thier  effects  in 
different  cases.  The  use  of  a  no n p a r a me t r i c  ANOVA  could 
simplify  the  statistical  analysis  of  several  DBMS 
modifications  implemented  across  more  than  one  Data  Base. 

The  Rank-Sum  Test  is  capable  of  doing  the  same  analysis  in  a 
step  by  step  fashion  through  the  use  of  multiple  pair-wise 
comparisons.  This  is  a  conceptually  simpler  procedure  that 
can  be  just  as  effective  as  the  nonparame tr ic  ANOVA. 

All  the  parameters  measured  by  the  instrumentation 
utility  can  be  statistically  compared  between  two 
measurement  session  statistical  files.  The  parameters  are 
the  following. 
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Software  Implementation  Testin 


The  system  test  plan  presented  in  appendix  C  was 
applied  in  order  to  validate  the  effectiveness  of  the 
software,  and  its  ability  to  meet  the  requirements 
specifications  in  Appendix  A.  In  all  cases  the  software  was 
developed  so  that  the  specifications  were  met  and  the  Test 
Plan  successfully  completed.  See  Appendix  F  for  the  test 
results . 

DBMON  Operation 

The  details  of  DBMON  operation  are  contained  in 
Appendix  E,  the  DBMON  User's  Guide.  This  section  discusses 
some  of  the  general  operating  features  of  DBMON.  Figure 
IV-5  presents  the  general  Data  Flow  Diagram  for  DBMON .  An 
example  of  DBMON  operation  and  the  application  of  the  DBMON 
User's  Methodology  is  presented  in  Chapter  V. 

An  application  program  that  uses  either  the  TOTAL  or 
INGRES  DBMS  is  required  for  use  with  DBMON.  The  application 
program  can  be  written  in  any  language  that  allows  calls  to 
VAX  VMS  Macro  subroutines.  This  program  will  have  calls  to 
the  Instrumentation  Utility  placed  before  and  after  each 
DBMS  command.  The  utility  calls  will  identify  the  calling 
program  and  the  DML  command  which  is  to  be  monitored.  When 
run  the  application  program  will  execute  the  Instrumentation 
Utility  and  build  a  file  of  raw  measurement  data.  During 
this  measurement  session  computer  system  parameters  will 
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also  be  measured  to  produce  the  system  parameter  report. 

The  DBMON  User  Interface  Program  is  used  to  set  up  a 
measurement  session.  The  user  specifies  the  type  of 
performance  measures  that  are  required,  and  the  duration  of 
the  measurement.  This  process  initiates  the  measurement 
session.  During  the  session  system  statistics  are  gathered 
and  the  DBMS  application  program  is  run.  At  the  end  of  the 
session  the  Data  Analysis  Program  is  run  to  produce  the 
instrumentation  report. 

The  DBMON  User  Interface  Program  can  now  be  used  to 
view  performance  measurement  reports  directly,  view  reports 
graphically,  and  analyze  the  measurement  data  statistically 
If  the  report  is  required  for  future  use,  it  may  be  stored 
in  the  report  library. 

Once  collected  and  analyzed,  the  DBMS  analyst  can  use 
the  DBMON  provided  information  to  help  solve  DBMS 
performance  problems.  Experiments  may  be  conducted  with 
instrumented  DBMS  application  programs.  The  before  and 
after  test  results  can  be  statistically  compared  to 
determine  the  significance  of  the  tested  modifications.  A 
more  detailed  analysis  of  the  DBMS  problem  solving  process 
is  presented  in  the  DBMON  User's  Guide  in  Appendix  E. 
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Summa  ry 

This  chapter  presented  the  implementation  of  software 
modifications  to  the  DBMON  system*  The  chapter  contained 
the  implementation  plan,  DBMS  and  programming  language 
selection,  develpment  computer  configuration,  general 
software  implementation  description,  and  general  DBMON 
operation  description.  Appendix  E  contains  the  DBMON  User's 
Manual.  Appendix  F  contains  the  Test  Plan  Results. 
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V .  Results,  Conclusions,  and  Recommendations 


Introduction 

This  chapter  contains  the  results  of  this  study's 
continued  development  of  the  DBMON  performance  monitor, 
conclusions  derived  from  this  study,  and  recommendations  for 
the  further  development  of  DBMON. 

Implementat ion 

DBMON  development  generally  followed  the  previous 
design  approaches  (2;5)«  This  study  primarily  concerned 
itself  with  a  completion  of  the  unimplemented  portions  of 
DBMON  (see  Chapter  II).  Specifically  the  following  items 
were  implemented  during  this  thesis  effort: 

1.  The  DBMON  system  was  interfaced  with  the  INGRES  DBMS. 

2.  A  capability  was  provided  for  the  graphical  display  of 
DBMS  performance  measurement  information. 

3.  The  ability  to  determine  statistical  differences 
between  sets  of  performance  data  was  implemented.  This 
allows  the  determination  of  statistical  difference  between 
data  sets . 

4.  A  means  of  maintaining  historical  performance  data  in 
a  report  library  was  provided. 

5.  A  DBMON  User  Methodology  was  developed  for  use  with 
the  DBMON  system. 
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6.  Online  help  information  was  included  for  the  DBMON 
menus  . 

7.  A  comprehensive  DBMON  User's  Guide  was  completed. 

The  DBMON  system  is  documented  through  the  use  of  S  A  D  T 
diagrams  and  an  associated  data  dictionary.  Further  detail 
is  provided  by  structure  charts  and  their  accompanying  data 
dictionary.  All  code  written  for  DBMON  is  fully  commented 
and  adheres  to  AFIT/ENG  documentation  standards  (1). 

Result  s 

The  result  of  this  thesis  effort  is  a  comprehensive 
data  base  performance  measurement  tool.  As  a  stand  alone 
software  tool  it  Is  capable  of  providing  the  DBMS  analyst 
the  information  needed  to  diagnose  performance  problems,  and 
test  performance  Improvement  modifications.  The  following 
discussion  illustrates  the  use  of  the  DBMON  system  through 
the  use  of  the  DBMON  User's  Methodology. 

DBMON  was  applied  to  the  Data  Analysis  Program  which  is 
a  part  of  the  DBMON  software.  The  DBMON  User's  Methodology 
guide!  the  performance  Improvement  process  with  the 
following  steps: 

(1)  Understanding  System  -  Familiarization  with  the  computer 
system,  DBMSs,  and  the  DBMON  system  was  gained  during  the 
course  of  this  thesis  effort. 

(2)  Example  Identification  of  Problem  Areas  -  During  testing 


of  the  Data  Analysis  program,  it  became  evident  that  the 
response  time  was  lengthy  (more  than  10  minutes).  As  a 
matter  of  convenience  an  improvement  in  program  response 
time  would  be  useful.  The  use  of  INGRES  calls  became  the 
prime  suspect  in  the  lengthy  response  times,  since  the 
previous  version  of  the  data  analysis  program  ran  quickly 
(less  than  1  minute).  In  order  to  evaluate  the  response 
time  contribution  to  the  program  overall  response  time,  the 
program's  INGRES  calls  were  instrumented  with  the  DBMON 
instrumentation  utility.  The  instrumented  program  was  run 
during  a  measurement  session,  and  the  resulting  measurement 
data  was  analyzed.  A  statistical  analysis  file  was  created 
against  which  to  guage  any  future  performance  improvements. 
Graphical  analysis  of  the  measurement  data  as  well  as 
examination  of  the  Instrumentation  report  (Figure  V  — 1 ) 
revealed  an  average  response  time  of  1.1  seconds. 
Considering  that  703  INGRES  instructions  were  executed,  12. 
minutes  of  Data  Analysis  Program  execution  time  could  be 
attributed  to  DBMS  activity. 

(3)  Example  Formulation  of  a  Performance  Improvement 
Hypothesis  -  The  collected  measurement  data  was  analyzed, 
and  it  became  evident  that  more  than  90%  of  the  program 
response  time  was  attributed  to  its  embedded  INGRES  calls. 
Figure  V-l  shows  the  measurement  report  for  the 
p r e - imp r o veme n t  data  base.  From  examination  of  INGRES 
reference  manuals  (14),  a  possible  performance  improvement 
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would  be  to  use  the  INGRES  provided  optimization  features  in 
order  to  restructure  the  Data  Base  into  a  hash  structure 
from  its  initial  heap  structure. 

(4)  Test  Performance  Improvements  -  During  this  step  the 
data  base  was  optimized  using  INGRES  supplied  procedures 
(14)  OPTIMIZEDB  and  SYSMOD.  The  instrumented  data  analysis 
program  was  run  again  and  a  second  set  of  measurement  data 
collected.  This  data  was  analyzed  and  a  statistical 
analysis  file  was  created.  Figure  V-2  is  the 
instrumentation  report  for  this  session.  The  performance 
improvements  reduced  INGRES  response  times  approximately 
50%.  From  examination  of  the  reports  it  can  be  seen  that 
the  improvements  came  partially  as  a  result  of  less  CPU  time 
used,  but  primarily  because  of  the  much  smaller  number  of 
page  faults  encountered  in  the  restructured  data  base. 

These  observation  were  confirmed  through  the  statistical 
comparison  the  the  statistical  analysis  files  created  for 
both  measurement  sessions. 

(5)  Implement  Performance  Improvement  Modifications  -  Due  to 
the  clear  benefits  of  the  hash  data  base  structure  it  has 
been  adopted  for  use  by  the  DEMON  data  base  and  has  been 
specified  in  the  DBMON  User's  Guide.  The  User's  Guide 
indicates  the  proper  procedures  required  to  install  the 
hashed  INGRES  data  base  structure. 


FIGURE  V-2  POST  MODIFICATION  INTRU MENTATION  REPORT 


(1)  Statistical  analysis  can  be  extended  to  allow  for  a 


no npa r ame t r i c  analysis  of  variance  (ANOVA).  This  would 
allow  for  a  more  simple  statistical  evaluation  process  in 
the  case  of  multiple  factor  analysis. 

(2)  Graphical  analysis  of  performance  data  can  be 
extended  to  provide  for  a  greater  variety  of  graphical 
representations,  such  as  scattergrams  and  pie  charts. 

This  would  help  customize  DBMOtV  to  the  personal 
preferences  of  the  monitor  users.  An  interface  to  the  ISO 
Graphic  Kernal  System  (GKS)  may  be  appropriate. 

(3)  D  B  M  0  N  '  s  ability  to  function  with  DBMSs  can  be 
extended  to  DISC'S  DATATRIEVE  (9).  This  would  further 
enhance  DBMON's  applicability  and  scope  of  usability. 

(4)  Improvments  to  the  User  Interface  can  be  made  by  the 
incorporation  of  a  color  monitor.  Color  can  be  used  to 
highlight  the  menus  and  graphics  produced  by  DBMON  to 
emphasize  important  information.  GKS  may  be  appropriate 
for  this  application. 
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Functional  Requirements 


Introduce  ion 


This  appendix  contains  the  complete  set  of  functional 
requirements  for  a  DBMS  performance  monitor  derived  from 
Appendix  A  of  reference  (5).  These  requirements  include  the 
additions  to  DBM ON  made  during  this  study.  Changes  and 


additions  are  in  items  3.2,  A. 4,  A. 5,  and  3.0. 
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FUNCTIONAL  REQUIREMENTS  OF  A  DBMS  PERFORMANCE  MONITOR 


1.0  Establish  a  user  interface  to  the  monitor. 

1.1  Allow  the  user  to  select  a  set  of  performance 
parameters  to  be  measured. 

1.2  Allow  the  user  to  specify  and  initiate  the 
measurement  collection  process. 


1.3  Allow  Lhe  user  to  check  the  status  of  the 
measurement  performance  process. 

1.4  Allow  the  user  to  terminate  the  measurement 
collection  process  gracefully. 

1.5  Allow  the  user  to  specify  the  types  of  analysis  to 
be  performed  on  the  measurement  data. 


1.6  Allow  the  user  to  specify  the  method  of  data 


presentation. 


2.0  Measure  the  selected  set  of  performance  data. 

2.1  Record  measurement  data  in  data  files. 

2.2  Map  the  selected  performance  parameters  to  the 
measurement  sources. 

2.3  Minimize  monitor  artifact  by  recording  only  the 
requested  set  of  performance  parameters. 

2.4  Start  the  measurement  session  at  the  specified 


2.5  Stop  the  measure m out  session  at  the  specified 


k'.V.V 


time  . 


3.0  Analyze  the  measured  values  for  the  performance 
parameters. 

3.1  Perforin  the  required  mathematical  operations  to 
provide  the  requested  performance  data. 

3-1.1  Create  a  file  of  analyzed  performance 
measurement  data. 

3.2  Perform  the  necessary  s t a t i s t  i  c a  1  / g r a p h  i  c a  1 
analysis. 

3.2.1  Allow  the  user  to  specify  statistical  tests 
to  be  performed  on  the  measurement  data. 

3.2.2  Allow  the  user  to  specify  graphical 
representations  to  be  made  of  the  measurement  data. 

3.2.3  Create  output  files  of  statistical  and 
graphical  analysis  data. 

4.0  Present  the  measurement  data  to  the  user. 

4.1  Create  the  performance  report. 

4.2  Print  the  performance  report  upon  the  system 
printer  in  as  many  copies  as  needed. 

4.3  Display  the  performance  report  upon  a  video 
terminal . 

4.4  Display  graphical  presentations  of  the  specified 
performance  measurement  data. 

4.5  Allow  the  user  to  maintain  historical  performance 


mcasur 


i  n  a  1 


report 


report 


ement  data  in  a  library. 

4.5.1  Allow  the  user  to  store  performance  re 
i  b  r  a  r  y  . 

4.5.2  Allow  the  user  to  retrieve  performance 
s  from  a  library. 

4.5.3  Allow  the  user  to  delete  performance 
s  from  a  library. 


5.0  Have  all  operating  instructions  and  procedures  in  a 
comprehensive  DBM ON  user's  manual. 
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This  appendix  contains  the  current  complete  design 
documentation  for  a  DBMS  performance  monitor.  The 
documentation  consists  of  an  index  of  SADT  activity 
diagrams,  the  activity  diagrams,  and  a  data  dictionary, 
data  dictionary  specifies  the  composition  and 
characteristics  of  the  data  elements  in  the  SADI  diagram 
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A-0  DBMS  Performance  Monitor  Context  Diagram 
AO  DBMS  Performance  Monitor 


A1  User  Interface 


All  Accept  and  Evaluate  User  Input 
A 12  Build  Set  of  Performance  Parameters 
A 13  Build  Performance  Tool  Option  List 
A  1  A  Build  Analysis  Commands 
A 15  Build  Presentation  Commands 
A16  Display  Screen  Format 

Measure  System  and  DBMS 

A2  1  Map  Performance  Parameters  to  Measurement  Source 
A22  Create  Performance  Tool  Commands  or  Instructions 
A23  Create  or  Initialize  Measurement  Data  Files 
A2A  Activate  Performance  Tools 
A25  Connect  Performance  Tools 


A3  Analyze  Measurement  Data  Files 


A  31  Analyze  Measurement  Data  Files 

A32  Perform  Statistical/Graphical  Analysis 

A  A  Present  Performance  Measurement  to  User 

AA  1  Create  Performance  Parameter  Report 

AA  1  1  Partition  Values  by  Performance  Index 
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AA  1  3  Create  Page  Two 

AA1A  Create  Page  Three  and  Four 

AA15  Combine  Pages 

A  A  2  Perform  Library  Management 
AA21  Store  Report 
AA22  Retrieve  Report 
AA 2 3  Delete  Report 

AA3  Present  Performance  Data  to  User 
AAA  Display  Page  to  User 
A  A  5  Print  Page 
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PRESENTATION  commands 


PRESENT  PERFORMANCE  MEASUREMENT  TO  USER 


USER  C0NMAN85 


PERFORMANCE  REPORT  LIBRARY  PROGRAMS 


SYSTEM  DESIGN  DOCUMENTATION 


SADT 


A-0  DBMS  Performance  Monitor  Context  Diagram 

Abstract:  This  diagram  is  the  context  diagram  which  provid 
a  top  level  view  of  the  system  design  of  a  DBMS  Performanc 
Monitor. 
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SADT 


AO  DBMS  Performance  Monitor 

Abstract:  This  diagram  shows  the  four  major  activities  that 

must  be  accomplished  by  the  DBMS  Performance  Monitor. 

A1  User  Interface  -  This  Activity  accepts  the  user's 
input  to  the  DBMS  Performance  Monitor.  It  allows  the  user 
to  specify  the  set  of  performance  parameters  to  be  measured, 
the  start  and  stop  time  of  the  measurement  session,  the 
types  of  data  analysis  to  be  performed,  and  how  the 
measurement  data  is  to  be  presented.  The  data  specified  by 
ihe  user  is  formatted  into  command  sets  which  are  used  as 
the  interface  mechanism  to  other  major  activities  of  the 
performance  monitor. 

A 2  Measure  System  and  DBMS  -  This  activity  initiates 
the  performance  measurement  tools  which  record  values  for 
the  selected  set  of  performance  parameters. 

A3  Analyze  Measurement  Data  Files  -  This  activity 
takes  the  measurement  data  files  produced  by  the  performance 
tools  and  performs  statistical  and  graphical  manipulations 
on  the  data.  It  calculates  parameters  that  are  not  directly 
measureable,  conducts  statistical  analysis,  and  produces 
graphical  representations  of  the  data. 

A4  Present  Performance  Measurement  Data  to  User  -  This 
activity  presents  the  performance  measurement  report  to  the 
user  and  maintains  a  historical  library  of  performance 
reports  . 
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A1  User  Interface 

Abstract:  This  Activity  accepts  the  user's  input  to  the  DBMS 
Performance  Monitor.  It  allows  the  user  to  specify  the  set 
of  performance  parameters  to  be  measured,  the  start  and  stop 
time  of  the  measurement  session,  the  types  of  data  analysis 
to  be  performed,  and  how  the  measurement  data  is  to  be 
presented.  The  data  specified  by  the  user  is  formatted  into 
command  sets  which  are  used  as  the  interface  mechanism  to 
other  major  activities  of  the  performance  monitor. 

All  Accept  and  Evaluate  User  Input  -  This  activity 
accepts  the  data  entered  by  the  user  and  evaluates  it  to 
determine  which  processing  activity  the  data  must  be  passed 
to  for  building  a  command  set.  It  also  determines  when  the 
user  wants  to  exit  the  user  interface. 

A12  Build  Set  of  Performance  Parameters  -  This 
activity  builds  the  set  of  performance  parameters  the  user 
wants  to  measure. 

A13  Build  Performance  Tool  Option  List  -  This  activity 
constructs  the  list  of  performance  tool  options. 

A1A  Build  Analysis  Commands  -  This  activity  builds  the 
commands  used  to  control  the  execution  of  the  analysis 
programs  and  the  statistical  package. 

A15  Build  Presentation  Commands  -  This  activity  builds 
the  commands  used  to  control  the  execution  of  data 
presentation  programs. 

Alb  Display  Screen  Format  -  This  activity  displays 
screen  formats  and  error  messages  onto  the  user's  terminal. 
This  is  the  key  activity  that  interacts  with  the  user. 
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A2  Measure  System  and  DBMS 

Abstract:  This  activity  initiates  the  performance  tools 

which  measure  and  record  values  for  the  selected  set  of 
performance  parameters. 

A21  Map  Performance  Parameters  to  Measurement  Source  - 
This  activity  selects  the  performance  tools  required  to 
measure  values  for  the  set  of  performance  parameters  selected 
by  the  monitor  user. 

A22  Create  Performance  Tool  Commands  or  Instructions  - 
This  activity  creates  the  system  commands  used  to  initiate 
the  performance  tools.  In  the  event  a  command  cannot  be 
created  because  the  performance  tool  cannot  be  automatically 
initiated,  a  set  of  instructions  for  connecting  the 
performance  tool  to  the  system  and  initiating  its  operation 
are  created. 

A23  Create  or  Initialize  Measurement  Data  Files  -  This 
activity  creates  new  files  or  initializes  old  files  used  to 
record  the  measured  values  of  the  performance  parameters. 

A24  Activate  Performance  Tools  -  This  activity  causes 
the  performance  tools  to  activate  and  begin  measuring  the 
system  and  the  DBMS. 

A 25  Connect  Performance  Tools  -  This  activity  describes 
the  connection  process  of  a  performance  tool,  such  as  a 
hardware  monitor,  that  requires  operator  intervention  before 
it  can  be  used  to  measure  DBMS  performance. 
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A3  Analyze  Measurement  Data  Files 


Abstract:  This  activity  takes  the  measurement  data  files 

produced  by  the  performance  tools  and  performs  statistical 
and  graphical  manipulations  on  the  data.  It  calculates 
parameters  that  are  not  directly  measureable,  conducts 
statistical  analysis,  and  produces  graphical  representations 
of  the  data. 

A3  1  Analyze  Measurement  Data  Files  -  This  activity 
uses  math -statistical  packages  and  specialized  analysis 
programs  to  perform  mathematical  analysis  on  the  measurement 
data.  These  calculations  are  used  to  derive  values  for 
performance  parameters  that  are  not  otherwise  directly 
measureab le . 

A32  Perform  Statistical/Graphical  Analysis  -  This 
activity  uses  statistical  and  graphical  packages  to  perform 
analysis  of  the  measurement  data.  It  produces  analysis 
results  such  as  histograms,  scattergrams,  regression 
analysis,  hypothesis  testing,  etc. 
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A4  Present  Performance  Measurement  Data  to  User 

Abstract:  This  activity  presents  the  performance 

measurement  report  to  the  user  and  maintains  a  historical 
library  of  performance  reports. 

A  4  1  Create  Performance  Parameter  Report  -  This 

activity  creates  a  report  of  the  measured  values  for  the 
performance  parameters  organized  by  their  corresponding 
performance  index  and  parameter  names. 

A42  Perform  Library  Management  -  This  activity 
maintains  a  library  of  historical  performance  reports. 

A43  Present  Performance  Data  to  User  -  This  activity 
controls  the  presentation  of  the  performance  data  to  the 
user  of  the  monitor. 

A44  Display  Page  to  User  -  This  Activity  displays  a 
page  of  the  performance  measurement  report  on  the  screen  of 
the  user  terminal.  It  allows  the  user  to  selectively  view 
the  desired  parts  of  the  performance  measurement  report. 

A45  Print  Page  -  This  activity  prints  a  page  of  the 
performance  report  on  the  system  printer. 
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AA  1  Create  Performance  Parameter  Report 

Abstract:  This  activity  creates  a  report  of  the  measured 
values  for  the  performance  parameters  organized  by  their 
corresponding  performance  index  and  parameter  names. 

AA  1  1  Partition  values  by  Performance  Index  -  This 
activity  reads  the  analyzed  measurement  data  files  and 
organizes  the  values  according  to  their  corresponding 
performance  index  and  performance  parameter  name. 

A  A  12  Create  Page  One  -  This  activity  creates  the  firs 
page  of  the  performance  parameter  report  which  contains  all 
tlie  effectiveness  measures. 

AA13  Create  Page  Two  -  This  activity  creates  the 
second  page  of  the  performance  parameter  report  which 
contains  the  allocation  values  of  the  efficiency  measures. 


AA1A  Create  Page  Three  and  Four  -  This  activity 
creates  the  third  and  fourth  pages  of  the  performance 
parameter  report.  These  pages  contain  all  the  utilization 
values  of  the  efficiency  measures. 

AA15  Combine  Pages  -  This  activity  compiles  all  the 
parts  of  the  performance  parameter  report. 
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A4  2  Perform  Library  Management 

Abstract:  This  activity  maintains  a  library  of  historical 
performance  reports. 

A421  Store  Report  -  This  activity  stores  performance 
reports  into  a  library  for  future  use. 

A4  2  2  Retrieve  Report  -  This  activity  retrieves  stored 
reports  for  viewing  by  the  monitor  user. 

A4  2  3  Delete  Report  -  This  activity  deletes  reports 
from  the  library  at  the  user's  request. 
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TYPE :  Activity 
DATE:  05  JUL  85 
NUMBER:  A-0 

NAME:  DBMS  Performance  Monitor  Context  Diagram 
INPUTS:  User  Input 

OUTPUTS:  Performance  Measurement  Report 
CONTROL:  None 

MECHANISMS:  System  Instrumentation,  Performance  Measurement 
Tools 

DESCRIPTION:  Top  level  view  of  the  DBMS  Performance  Monitor 
RELATED  REQUIREMENT  NUMBER:  All 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  AO 

NAME:  DBMS  Performance  Monitor 
INPUTS:  User  Input 

OUTPUTS:  Performance  Measurement  Report 
CONTROL:  None 

MECHANISMS:  System  Instrumentation,  Performance  Measurement 
Tools 

DESCRIPTION:  This  diagram  shows  the  four  main  activities 
that  are  accomplished  by  the  DBMS  Performance  Monitor. 
RELATED  REQUIREMENT  NUMBER:  All 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A 1 

NAME:  User  Interface 
INPUTS:  User  Input 

OUTPUTS:  Exit,  Measurement  Control  Commands,  Analysis 
Commands,  Presentation  Commands 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  accepts  the  user's  input  to  the 
DBMS  Performance  Monitor.  It  allows  the  user  to  specify  the 
set  of  performance  parameters  to  be  measured,  the  start  and 
stop  times  of  the  measurement  session,  the  types  of  data 
analysis  to  be  performed,  and  how  the  measurement  data  is  to 
be  presented.  The  data  specified  by  the  user  is  formatted 
into  command  sets  which  are  used  as  the  interface  mechanism 
to  the  other  major  activities  of  the  performance  monitor. 
RELATED  REQUIREMENT  NUMBER:  1.0 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  All 

NAME:  Accept  and  Evaluate  User  Input 
INPUTS:  User  Input 

OUTPUTS:  Exit,  Performance  Parameter  Data,  Analysis  Data, 
Presentation  Data 
CONTROL:  Screen  Displayed 
MECHANISMS:  Terminal 

DESCRIPTION:  This  activity  accepts  the  data  entered  by  the 
user  and  evaluates  it  to  determine  which  processing  activity 
the  data  must  be  passed  to  for  building  a  command  set.  It 
also  determines  when  the  user  wants  to  exit  the  user 
interface . 

RELATED  REQUIREMENT  NUMBER:  1.0 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A 1  2 

NAME:  Build  Set  of  Performance  Parameters 
INPUTS:  Performance  Parameter  Data 

OUTPUTS:  Screen  Format  Command,  Set  of  Performance 

Parameters 

CONTROL:  None 

MECHANISMS:  None 

DESCRIPTION:  This  activity  builds  the  set  of  performance 
parameters  the  user  wants  to  measure. 

RELATED  REQUIREMENT  NUMBER:  1.1 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A13 

NAME:  Build  Performance  Tool  Option  List 
INPUTS:  Performance  Tool  Data 

OUTPUTS:  Screen  Format  Command,  Performance  Tool  Option  List 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  Tli  is  activity  builds  the  option  list  for  the 
performance  tools 

RELATED  REQUIREMENT  NUMBER:  1.1 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A 1 4 

NAME:  Build  Analysis  Commands 
INPUTS:  Analysis  Data 

OUTPUTS:  Screen  Format  Command,  Analysis  Commands 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  builds  the  commands  used  to 
control  the  execution  of  the  analysis  programs  and  the 
statistical/graphical  package. 

RELATED  REQUIREMENT  NUMBER:  1.5 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A15 

NAME:  Build  Presentation  Commands 
INPUTS:  Presentation  Data 

OUTPUTS:  Screen  Format  Command,  Presentation  Commands 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  builds  the  commands  used  to 
control  the  execution  of  data  presentation  programs. 
RELATED  REQUIREMENT  NUMBER:  1.6 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
HUMBER:  A2 1 

NAME:  Map  Performance  Parameters  to  Measurement  Source 
INPUTS:  Set  of  Performance  Parameters,  Parameter  Source 
Tab  1  e 

OUTPUTS:  List  of  Required  Performance  Tools 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  selects  the  performance  tools 
required  to  measure  values  for  the  set  of  performance 
parameters  selected  by  the  user  of  the  monitor. 

RELATED  REQUIREMENT  NUMBER:  2.2 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A22 

NAME:  Create  Performance  Tool  Commands  or  Instructions 
INPUTS:  List  of  Required  Performance  Tools 
OUTPUTS:  Performance  Tool  Commands  or  Instructions 
CONTROL:  Tool  Setup 
MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  the  system  commands  used 
to  initiate  the  performance  tools.  In  the  event  a  command 
cannot  be  created  because  the  per  formace  tool  cannot  be 
automatically  initiated,  a  set  of  instructions  for 
connecting  the  performance  tool  to  the  system  and  initiating 
its  operation  are  created. 

RELATED  REQUIREMENT  NUMBER:  2.0 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A23 

NAME:  Create  or  Initialize  Measurement  Data  Files 
INPUTS:  None 

OUTPUTS:  Initialized  Files 
CONTROL:  Data  Files  Setup 
MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  new  files  or  initalizes 
old  files  used  to  record  the  measured  values  of  the 
performance  parameters. 

RELATED  REQUIREMENT  NUMBER:  2  .  ti 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A2A 

NAME:  Activate  Performance  Tools 
INPUTS:  Tool  Commands,  Initialized  Files 
OUTPUTS:  Measurement  Data  Files 
CONTROL:  None 

MECHANISMS:  System  Instrumentation 

DESCRIPTION:  This  activity  causes  the  performance  tools  to 
activate  and  begin  measuring  the  system  and  the  DBMS. 
RELATED  REQUIREMENT  NUMBER:  2.4 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A25 

NAME:  Connect  Performance  Tools 

INPUTS:  Tool  Instructions,  Initialized  Files 

OUTPUTS:  Measurement  Data  Files 

CONTROL:  None 

MECHANISMS:  System  Instrumentation 

DESCRIPTION:  This  activity  is  the  connection  process  of  a 
performance  tool  that  requires  operator  intervention  before 
it  can  begin  to  function. 

RELATED  REQUIREMENT  NUMBER:  2.0 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A3 

NAME:  Analyze  Measurement  Data  Files 
INPUTS:  Measurement  Data  Files 

OUTPUTS:  Analyzed  Measurement  Data  Files,  Statistical 
Analysis  Files,  Graphical  Analysis  Files 
CONTROL:  Analysis  Commands 

MECHANISMS:  Statistical/ Graphical  Package,  Analysis  Programs 
DESCRIPTION:  This  activity  takes  the  measurement  data  files 
produced  by  the  performance  tools  and  performs  mathematical 
analysis  on  the  data.  It  calculates  values  for  performance 
parameters  that  are  not  directly  measureable  as  well  as 
performing  statistical/graphical  analysis  on  the  data  files. 
RELATED  REQUIREMENT  NUMBER:  3.0 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  35 
NUMBER:  A3 1 

NAME:  Analyze  Measurement  Data  Files 

INPUTS:  Set  of  Performance  Parameters,  Measurement  Data 
Files,  Parameter  Source  Table 
OUTPUTS:  Analyzed  Measurement  Data  Files 
CONTROL:  Analysis  Commands 

MECHANISMS:  Statistical  Package,  Analysis  Programs 
DESCRIPTION:  This  activity  uses  the  statistical  package  and 
specialized  programs  to  perform  mathematical  calculations  on 
the  measurement  data.  These  calculations  are  used  to  derive 
performance  parameters  that  are  not  directly  ineasureable. 
RELATED  REQUIREMENT  NUMBER:  3.1 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A32 

NAME:  Perform  Statistical/Graphical  Analysis 

INPUTS:  Measurement  Data  Files,  Analyzed  Measurement  Data 

Files 

OUTPUTS:  Statistical  and  Graphical  Analysis  Files 
CONTROL:  Analysis  Commands 

MECHANISMS:  Statistical/Graphical  Package 

DESCRIPTION:  This  activity  uses  the  statistical  package  to 
perform  statistical  analysis  of  the  measurement  data.  The 
Graphical  package  is  used  to  format  measurement  data  into  a 
graphical  presentation. 

RELATED  REQUIREMENT  NUMBER:  3.2 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4 

NAME:  Present  Performance  Data  to  User 

INPUTS:  Analyzed  Measurement  Data  Files,  Statistical  and 
Graphical  Analysis  Files 

OUTPUTS:  Performance  Measurement  Report 
CONTROL:  Presentation  Commands 
MECHANISMS:  Display  Device 

DESCRIPTION:  This  activity  presents  the  performance 
measurement  data  to  the  user  in  the  form  of  a  performance 
measurement  report. 

RELATED  REQUIREMENT  NUMBER:  4.0 
ALIASES:  None 
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IYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4 1 

t.'AME:  Create  Performance  Parameter  Report 

INPUTS:  Analyzed  Measurement  Data  Files,  Parameter  Source 
Tab  1  e 

OUTPUTS:  Performance  Measurement  Report 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  a  report  of  the  measured 
values  for  the  performance  parameters  organized  by  their 
corresponding  performance  index  and  parameter  names. 

RELATED  REQUIRE M L  N  T  NUMBER:  4.1 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4  1  1 

NAME:  Partition  Values  by  Performance  Index 

INPUTS:  Analyzed  Measurement  Data  Files,  Parameter  Source 
Table 

OUTPUTS:  Effectiveness  Measures,  Efficiency  Measures 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  reads  the  analyzed  measurement 
data  files  and  organizes  the  values  according  to  their 
corresponding  performance  index  and  parameter  names* 
RELATED  REQUIREMENT  NUMBER:  4.1 
ALIASES:  None 


TYPE:  Activity 

DATE:  05  JUL  85 

NUMBER:  A4  12 

NAME:  Create  Page  One 

INPUTS:  Effectiveness  Measures 

OUTPUTS:  Page  One 

CONTROL:  None 

MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  the  first  page  of  the 
performance  report  which  contains  all  of  the  effectiveness 
measures . 


RELATED 

ALIASES 


REQUIREMENT  NUMBER:  4.1 
None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A413 
NAME:  Create  Page  Two 

INPUTS:  Allocation/Deallocation  Values 
OUTPUTS:  Page  Two 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  the  second  page  of  the 
performance  parameter  report  which  contains  the  allocation 
and  deallocation  values  of  the  efficiency  measures. 

RELATED  REQUIREMENT  NUMBER:  4.1 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A414 

NAME:  Create  Page  Three  and  Four 
INPUTS:  Utilization  Values 
OUTPUTS:  Page  Three  and  Four 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  creates  the  third  and  fourth 
pages  of  the  performance  parameter  report  which  contains  the 
utilization  values  of  the  efficiency  measures. 

RELATED  REQUIREMENT  NUMBER:  4.1 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4  1  5 
NAME:  Combine  Pages 

INPUTS:  Page  One,  Page  Two,  Page  Three,  and  Page  Four 
OUTPUTS:  Performance  Parameter  Report 
CONTROL:  None 
MECHANISMS:  None 

DESCRIPTION:  This  activity  combines  the  pages  of  the  report 
into  one  consolidated  report. 

RELATED  REQUIREMENT  NUMBER:  4.1 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4 2 

NAME:  Perform  Library  Management 
INPUTS:  Performance  Parameter  Report 
OUTPUTS:  Performance  Parameter  Report 
CONTROL:  User  Commands 
MECHANISMS:  DBMS 

DESCRIPTION:  This  activity  maintains  a  library  of  historical 
performance  reports. 

RELATED  REQUIREMENT  NUMBER:  4.4 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A4  2  1 
NAME:  Store  Report 

INPUTS:  Performance  Parameter  Report 
OUTPUTS:  Exit,  Performance  Parameter  Report 
CONTROL:  User  Commands 
MECHANISMS  :  DBMS 

DESCRIPTION:  This  activity  stores  performance  parameter 
reports  into  the  report  library. 

RELATED  REQUIREMENT  NUMBER:  4.4 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A422 
NAME:  Retrieve  Report 

INPUTS:  Performance  Parameter  Report 
OUTPUT'S:  Performance  Parameter  Report 
CONTROL:  User  Commands 
MECHANISMS:  DBMS 

DESCRIPTION:  This  activity  retrieves  performance  parameter 
reports  that  have  been  stored  in  the  library. 

RELATED  REQUIREMENT  NUMBER:  4.4 
ALIASLS:  None 
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TYPE :  Activity 
DATE:  05  JUL  85 
NUMBER:  A423 
NAME:  Delete  Report 

INPUTS:  Performance  Parameter  Report 
OUTPUTS:  Exit 
CONTROL:  User  Commands 
MECHANISMS:  DBMS 

DESCRIPTION:  This  activity  deletes  performance  parameter 
reports  from  the  report  library. 

RELATED  REQUIREMENT  NUMBER:  4.4 
ALIASES:  None 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A43 

NAME:  Present  Performance  Data  to  User 

INPUTS:  Performance  Parameter  Report,  Statistical  Analysis 
Files,  Graphical  Analysis  Files 
OUTPUTS:  Terminal  Page,  Printer  Page 
CONTROL:  Presentation  Commands,  Paging  Commands 
MECHANISMS:  None 

DESCRIPTION:  This  activity  controls  the  presentation  of  the 
performance  data  to  the  user  of  the  monitor. 

RELATED  REQUIREMENT  NUMBER:  4.2 
ALIASES:  None 
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TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A44 

NAME:  Display  Page  to  User 
INPUTS:  Terminal  Page,  User  Input 

OUTPUTS:  Paging  Commands,  Terminal  Page,  Performance 
Measurement  Report 
CONTROL:  Hone 

MECHANISMS:  Display  Device 

DESCRIPTION:  This  activity  displays  a  page  of  the 
performance  measurement  report  or  the  graphical 
representation  on  the  screen  of  a  terminal.  It  allows  the 
user  to  selectively  view  and/or  print  the  desired  parts  of 
the  performance  measurement  report. 

RELATED  REQUIREMENT  NUMBER:  4.2,  4.4 

ALIASES:  None 
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Page,  Printer  Page 


TYPE:  Activity 
DATE:  05  JUL  85 
NUMBER:  A45 
NAME:  Print  Page 
INPUTS:  Terminal 
OUTPUTS:  Performance  Measurement  Report 
CONTROL:  None 

MECHANISMS:  System  Printer 

DESCRIPTION:  This  activity  prints  a  page  of 
measurement  report  on  the  system  printer. 
RELATED  REQUIREMENT  NUMBER:  4.2 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Allocation /Deallocation  Values 

DESCRIPTION:  Measured  values  for  the  allocation  and 
deallocation  performance  parameters  which  are  part  of  the 
system  efficiency  measures. 

SOURCES :  A 4 1 1 

DESTINATIONS:  A4 1 3 

COMPOSITION:  None 

PART  OP:  Efficiency  Measures 

DATA  TYPE:  Numeric 

VALUES:  0  to  Max  Size 

ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Analysis  Commands 

DESCRIPTION:  The  set  of  commands  used  to  control  the 
analysis  of  measurement  data  recorded  by  the  performance 
tools  . 

SOURCES  :  A1  ,  Al 4 
DESTINATIONS:  A3,  A3  1  ,  A32 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Analysis  Data 

DESCRIPTION:  Data  input  by  the  user  to  specify  how  the 
measurement  data  is  to  be  analyzed.  It  is  used  to  build  a 
set  of  Analysis  Commands. 

SOURCES:  All 
DESTINATIONS :  A14 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Numeric,  String 

VALUES:  0  to  Max  Size,  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Analysis  Programs 

DESCRIPTION:  Specially  designed  computer  programs  for 
analyzing  the  measurement  data  produced  by  the  performance 
tools  . 

SOURCES:  System  Program  Library 
DESTINATIONS:  A3,  A3 1 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Executable  Computer  Code 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYl’E:  Data  Element 
DATE:  05  JUL  85 

NAME:  Analyzed  Measurement  Data  Files 

DESCRIPTION:  Data  files  containing  the  measurement  data 
after  it  has  been  analyzed  by  the  analysis  programs  and  the 
statistical/graphical  package. 

SOURCES:  A3,  A31 

DESTINATIONS:  A32,  AA  ,  AA 1 ,  AA 1 1 

COMPOSITION:  None 

PART  OF:  N/A 

DA']' A  TYPE:  Numeric 

VALUES:  0  to  Max  Size 

ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Data  Files  Setup 

DESCRIPTION:  Part  of  the  performance  tool  options  list  used 
to  control  the  creation  and  initialization  of  the 
measurement  data  files. 

SOURCES:  A  1 3 
DESTINATIONS:  A23 
COMPOSITION:  None 

PART  OF:  Performance  Tool  Options  List 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Display  Device 

DESCRIPTION:  Device  used  to  display  the  performance 
measurements  to  the  user. 

SOURCES:  System  Hardware 

DESTINATIONS:  AA  ,  AAA 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE:  Hardware 

VALUES:  N/A 

ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Effectiveness  Measures 

DESCRIPTION:  A  major  category  of  performance  indexes  used  to 
classify  performance  parameters. 

SOURCES:  AA 1 1 
DESTINATIONS:  AA  1  2 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Numeric 
VALUES:  0  to  Max  Size 
ALIASES:  None 
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TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Efficiency  Measures 

DESCRIPTION:  A  major  category  of  performance  indexes  used  to 
classify  performance  parameters. 

SOURCES  :  AA  1  1 
DESTINATIONS:  A A  1 3  ,  AA  1  A 

COMPOSITION:  A  location /  Deallocation  Values,  Utilization 
V  a  lues 

PART  OF:  N/A 
DATA  TYPE:  Numeric 
VALUES:  0  to  Max  Size 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Error  Message 

DESCRIPTION:  Informational  message  to  be  displayed  to  a  user 

of  the  monitor  to  inform  of  incorrect  or  invalid  input. 

SOURCES:  A  1 2  ,  A  1 3 ,  A  1  A ,  A15 

DESTINATIONS:  A16 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
N A  M  E  :  Exit 

DESCRIPTION:  Denotes  a  user's 
of  tlie  monitor. 

SOURCES :  A1 ,  All 

DESTINATIONS:  Operating  System 

COMPOSITION:  None 

P  A  K  T  OP:  N / A 

DATA  TYPE:  N/A 

VALUES:  N/A 

ALIASES:  None 


exit  from  the  user  interface 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Exit  Library 

DESCRIPTION:  Denotes  a  user's  exit  from  the  performance  data 
library. 

SOURCES :  A42  ,  A A  2 1  ,  A423 

DESTINATIONS:  A4 3 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPL:  N/A 

VALUES:  H  /  A 

ALIASES:  None 


SALT!'  SYSTEM  DESIGN  DOCUMENTATION 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Graphical  Analysis  Files 

DESCRIPTION:  Files  containing  the  graphical  presentation  of 
performance  measurement  data. 

SOURCES:  A32 
DESTINATIONS:  A4 3 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Numeric 
VALUES:  0  to  Max  Size 
ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Initialized  Files 

DESCRIPTION:  Data  files  that  have  been  created  or 

initialized  before  the  beginning  of  a  measurement  session. 

SOURCES:  A23 

DESTINATIONS:  A24,  A25 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE  :  File 

VALUES:  System  Alphabet 

ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  List  of  Required  Performance  Tools 

DESCRIPTION:  List  of  tlie  performance  tools  that  must  be  used 
to  measure  values  for  the  set  of  performance  parameters 
selected  by  the  user. 

SOURCES :  A2 1 
DESTINATIONS:  A2 2 
COMPOSITION:  None 
PART  OF:  N / A 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  D  a  t  a  Element 

DATE:  05  JUL  85 

NAME:  Initialized  Files 

DESCRIPTION:  Data  files  that  have  been  created  or 

initialized  before  the  beginning  of  a  measurement  session 

SOURCES:  A23 

DESTINATIONS:  A24,  A25 

COMPOSITION:  None 

P  A  R T  OF:  N / A 

DATA  TYPE:  File 

VALUES:  System  Alphabet 

ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Measurement  Control  Commands 

DESCRIPTION:  Set  of  commands  used  to  specify  and  control  a 
performance  measurement  session. 

SOURCES:  A 1 ,  A1 2 ,  A1 3 
DESTINATIONS:  A2 ,  A2 1 ,  A3,  A31 

COMPOSITION:  Set  of  Performance  Parameters,  Performance  Tool 

Options  List 

PART  OF:  N/A 

DATA  TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 


TYPE :  Data  Element 

DATE:  05  JUL  85 

NAME:  Measurement  Data  Files 

DESCRIPTION:  Data  files  used  to  record  the  measurements 
taken  by  the  performance  tools. 

SOURCES:  A2 ,  A2A,  A25 
DESTINATIONS:  A3,  A3 1  ,  A32 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Numeric 
VALUES:  0  to  Max  Size 
ALIASES:  None 
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TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Next  Screen  Format 

DESCRIPTION:  Specifies  the  next  screen  format  to  be 
displayed  to  the  monitor  user. 

SOURCES:  A12,  A13,  A14,  A15 
DESTINATIONS:  A16 
COMPOSITION:  None 
PART  OF:  Screen  Format 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME :  Page  One 

DESCRIPTION:  Page  one  of  the  performance  parameter  report 
It  contains  the  effectiveness  measures. 

SOURCES:  A412 
DESTINATIONS:  A4 1 5 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Page  Two 

DESCRIPTION:  Page  two  o£  the  performance  parameter  report. 
It  contains  the  allocation/deallocation  values  of  the 
efficiency  measures. 

SOURCES:  A4  1  3 
DESTINATIONS:  A4  1  5 
COMPOSITION:  None 
PART  OP;  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
ALIASES  :  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Page  Three  and  Four 

DESCRIPTION:  Page  three  and  four  of  the  performance 
parameter  report.  It  contains  the  utilization  values  of  the 
efficiency  measures. 

SOURCES:  A414 
DESTINATIONS:  A4  1  5 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Paging  Commands 

DESCK1PTION:  Commands  used  to  control  the  displaying 

performance  parameter  report  on  the  terminal. 

SOURCES:  AAA 

DESTINATIONS:  AA 3 

COMPOSITION:  None 

PART  OP:  N/A 

DATA  TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Parameter  Source  Table 

DESCRIPTION:  Data  structure  used  to  map  a  performance 

parameter  to  a  source  it  can  be  measured  from. 

SOURCES:  DBMS  Monitor  Software 

DESTINATIONS:  A2 1  ,  A3  I  ,  AA 1 ,  AA 1 1 

COMPOSITION:  None 

PART  OF:  M/A 

DATA  TYPE:  Numeric,  String 

VALUES:  0  to  Max  Size,  System  Alphabet 

ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Measurement  Report 

DESCRIPTION:  Performance  measurement  report  presented  to 
monitor  users.  It  contains  values  for  the  performance 
parameters  and  statistical  analysis. 

SOURCES:  AA ,  AAA,  AA 5 
DESTINATIONS:  Monitor  User 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
A  L IAS  E  S  :  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Measurement  Tools 

DESCRIPTION:  Software/ hardware  tools  used  to  measure  and 
record  values  for  the  selected  set  of  performance 
parameters  . 

SOURCES:  System  Software 
DESTINATIONS:  A2 ,  A2A 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Executable  Code  or  Hardware  Device 
VALUES:  N/A 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Parameter  Data 

DESCRIPTION:  Data  input  by  the  user  to  specify  the  set  of 
performance  parameters  to  be  measured. 

SOURCES:  All 
DESTINATIONS:  A12 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Numeric,  String 

VALUES:  0  to  Max  Size,  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Parameter  Report 

DESCRIPTION:  Report  containing  values  for  the  set  of 
performance  parameters  selected  by  the  user. 

SOURCES:  AA1,  AA15,  AA2,  AA  2  1  ,  AA22 

DESTINATIONS:  AA2,  AA  2  1  ,  AA22,  AA23,  AA  3 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE:  Report 

VALUES:  System  Alphabet 

ALIASES:  None 
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T  Y  1‘  E  :  Data  Element 
DATE:  03  JUL  83 

NAME:  Performance  P.eport  Library  Commands 

DESCRIPTION:  User  input  that  directs  the  performance  report 
library . 

SOURCES:  User  Input 

DESTINATIONS:  A42,  A4 2 1 ,  A4  2  2  ,  A4  2  3 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE:  String 

VALUES:  System  Alp  h  abet 

ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Report  Library  Programs 
DESCRIPTION:  SofLware  that  enables  operation  of  the 
performance  report  library. 

SOURCES:  DBMS  Monitor  Software 
DESTINATIONS:  A42,  A4  2  1  ,  A4  2  2  ,  A4  2  3  ,  A4  3 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Executable  Code 
VALUES:  N/A 
ALIASES:  None 
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T  Y  T  E  :  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Tool  Commands  and  Instructions 
DESCRIPTION:  System  commands  and  instructions  for  initiating 
a  performance  tool  to  begin  measuring  and  recording  values. 
SOURCES:  A22 
DESTINATIONS:  A23,  A24 

COMPOSITION:  Tool  Commands,  Tool  Instructions 

PART  OF:  N/A 

DATA  TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Performance  Tool  Data 

DESCRIPTION:  Data  input  by  the  user  to  specify  operational 
parameters  for  the  performance  tools  (i.e.  start  time,  stop 
time).  It  is  used  to  build  the  performance  tool  options 


time).  It  is  used  to  b 
list. 

SOURCES:  All 
DESTINATIONS:  A  I  3 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Performance  Tool  options  List 

DESCRIPTION:  Set  of  options  used  to  create  a  complete 
command  for  a  performance  tool.  Typically  this  list 
contains  items  such  as:  start  time,  stop  time,  and  file 
options. 

SOURCES  :  A1  ,  A1 3 
DESTINATIONS:  A2 ,  A22,  A23 

COMPOSITION:  Tool  Setup,  Data  Files  Setup 
PART  OF:  Measurement  Control  Commands 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Presentation  Commands 

DESCRIPTION:  Set  of  commands  used  to  control  the 
presentation  of  the  measurement  data  to  the  user  of  the 
monitor. 

SOURCES:  Al,  A 1 5 
DESTINATIONS:  A4 ,  A4 3 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


T  Y I’ E  :  Data  Element 

DAT  E :  05  JUL  85 

NAME:  Presentation  Data 

DESCRIPTION:  Data  input  b 

measurement  data  is  to  be 

set  of  presentation  comma 

SOURCES :  All 

DEST 1  NAT  IONS:  A1  U 

COMPOSITION:  None 

PART  OF:  N  /  A 

DATA  TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Printer 
DESCRIPTION:  System  print 
tlie  performance  measureme 
SOURCES:  System  Hardware 
DESTINATIONS:  A A  5 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Hardware 
VALUES:  M/A 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Printer  Page 

DESCRIPTION:  Formatted  page  of  the  performance  measurement 
report  to  be  printed  on  the  system  printer. 

SOURCES:  A43 
DESTINATIONS:  A4 5 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Screen  Displayed 

DESCRIPTION:  Used  to  control  the  display  of  screen  formats 
and  the  entry  of  data  by  the  user.  It  ensures  that  the 
screen  format  has  been  displayed  before  the  user  attempts 
enter  any  data. 

SOURCES:  A  1 6 
DESTINATIONS:  All 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Boolean 
VALUES:  True  or  False 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Screen  Format 

DESCRIPTION:  Specifies  what  is  to  be  displayed  on  the 
terminal  when  a  user  is  entering  data  through  the  user 
interface. 

SOURCES:  A 1 2  ,  A  1 3  ,  A14,  A15 
DESTINATIONS:  A1  6 
COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYFE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Set  of  Performance  Parameters 

DESCRIPTION:  Specifies  the  set  of  performance  parameters  the 
user  of  the  monitor  wants  to  measure  and  record. 

SOURCES :  A1 ,  A 1 2 
DESTINATIONS:  A2 ,  A2 1  ,  A3 1 
COMPOSITION:  None 

PART  OF:  Measurement  Control  Commands 
DATA  TYPE:  String 
VALUES.:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Statistical  Analysis  Files 

DESCRIPTION:  Files  produced  as  a  result  of  performing 
statistical  analysis  on  the  measurement  data. 

SOURCES:  A3,  A32 
DESTINATIONS:  A4  ,  A43 

COMPOSITION:  None 
PART  OF:  N/A 
DATA  TYPE:  Numeric 
VALUES:  0  to  Max  Size 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  Statistical/Grapliical  Package 

DESCRIPTION:  Software  that  provides  statistical  analysis  and 

presents  performance  data  in  a  graphical  representation. 

SOURCES:  System  Program  Library 

DESTINATIONS:  A3,  A3  1  ,  A3  2 

COMPOSITION:  None 

PART  OF:  N/A 

DATA  TYPE:  Executable  Computer  Code 
VALUES:  N/A 
ALIASES:  None 
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TYPE:  Data  Element 
DATE:  05  JUL  85 

NAME:  System  Instrumentation 

DESCRIPTION:  The  system  facilities  used  to  connect 
performance  tools  to  the  measured  system. 

SOURCES:  System  Software,  Operating  System 
DESTINATIONS:  A2 ,  A2 5 
COMPOSITION:  None 
TART  OF:  N/A 

DATA  TYPE:  Executable  Code 
VALUES:  N/A 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Terminal 

DESCRIPTION:  Hardware  device  used  to  interface  with  the 
monitor  software. 

SOURCES:  System  Hardware 
DES II  NAT  1 ONS :  All,  A1 6 
COMPOSITION:  None 
PART  OF:  N/A 

DATA  TYPE:  Hardware  Device 
VALUES:  N/A 

ALLAS ES:  Display  Device 
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TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Terminal  Page 

DESCRIPTION:  Screen  content  being  displayed  upon  the  user's 
terminal. 

SOURCES:  A43,  A44 
DESTINATIONS :  A45 
COMPOSITION:  None 
PART  OP:  N/A 
DATA  TYPE:  Report 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Tool  Commands 

DESCRIPTION:  Commands  used  to  initiate  a  performance  tool  to 
begin  measuring  and  recording  values. 

SOURCES:  A22 
DESTINATIONS:  A24 
COMPOSITION:  None 

PART  OP:  Performance  Tool  Commands/ Instructions 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Tool  Instructions 

DESCRIPTION:  Instructions  for  connecting  and  initiating  a 
performance  tool  that  requires  human  intervention. 
SOURCES:  A22 
DESTINATIONS:  A25 
COMPOSITION:  None 

PART  OP:  Performance  Tool  Commands/ Instructions 

TYPE:  String 

VALUES:  System  Alphabet 

ALIASES:  None 


TYPE:  Data  Element 
DATE:  05  JUL  85 
NAME:  Tool  Setup 

DESCRIPTION:  Specifies  how  the  performance  tool  is  to  be 
setup  and  used. 

SOURCES:  Al,  A 1 3 
DESTINATIONS:  A2  2 
COMPOSITION:  None 

PART  OF:  Performance  Tool  Options  List 
DATA  TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 
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TYPE:  l)Jta  Element 
DATE:  05  JUL  85 
NAME:  User  Input 

DESCRIPTION:  Data  and  commands  entered  at  the  terminaL  by 
the  monitor  user. 

SOURCES:  Monitor  User 
DEST  l NAT  IONS:  Al  ,  All 
COMPOSITION:  None 
PART  OF:  N/A 
TYPE:  String 
VALUES:  System  Alphabet 
ALIASES:  None 


TYPE:  Data  Element 

DATE:  05  JUL  85 

NAME:  Utilization  Values 

DESCRIPTION:  Part  of  efficency  measures  that  are  place  d  on 

page  three  and  four  of  the  performance  parameter  report. 

SOURCES:  A4 1 

DESTINATIONS:  A4 A 

COMPOSITION:  None 

PART'  OF:  Efficiency  Measures 

DATA  TYPE:  Numeric 

VALUES:  0  to  Max  Size 

ALIASES:  None 
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l'ii  is  appendix  contains  the  additions  the  the  test  plan 
contained  in  Appendix  D  (2).  The  additions  to  the  test  plan 
correspond  to  the  changes  in  the  functional  requirements  in 
Appendix  A.  Test  plan  additions  in  this  appendix  correspond 


to  functional  requirements  3.2,  A. A,  A. 3  and  5.0 


TEST  PLAN  ADDITIONS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2  -  Perform  the  necessary  statistical  aiul/o 

graphical  analysis. 


TEST  CASES: 

1.  No  analysis  requested. 

2.  One  specific  analysis  requested. 

3.  AIL  possible  analysis  requested. 


EXPECTED  RESPONSE: 


1.  No  analysis  performed. 

2.  Requested  analysis  performed. 

3.  All  possible  analysis  performed. 


RESULTS : 

CASE  1. 

-  PASS: 

FAIL: 

DATE 

CASE  2. 

-  PASS: 

FAIL: 

DATE 

CASE  3. 

-  PASS: 

FAIL  : 

DATE 

TEST  PLAN  ADDITIONS 


Full  FUR  A  DUMS  PERFORMANCE  MONI 


REQU I  REMENT :  3.2.1  -  Allow  the  user  to  specify  stati 

tests  to  be  performed  on  the  measurement  data. 

TEST  CASES: 

l.  No  test  is  requested. 

2  .  One  specific  test  is  requested. 

3.  All  possible  tests  are  requested. 


EXPECTED  RESPONSE: 


1.  No  analysis  is  scheduled. 

2.  Requested  analysis  is  scheduled. 

3.  All  possible  analysis  is  scheduled. 


RESULTS : 


CASE  1.  -  PASS: _  FAIL: _  DATE: 

CASE  2.  -  PASS: _  FAIL: _  DATE: 

CASE  3.  -  PASS:  FAIL:  DATE: 


T  0  It 
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REMARKS  : 


TEST  PLAN  ADDITIONS  t'OK  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2.2  -  ALLow  the  user  to  specify  graphical 
representations  to  be  made  of  the  measurement  data. 

T E  S T  CASES  : 

1.  Mo  graphical  representation  is  requested. 

2.  One  graphical  representation  is  requested. 

3.  A  LI  possible  graphics  are  requested. 

EXPECTED  RESPONSE: 

1.  No  graphics  are  scheduled. 

2.  Requested  graphics  is  scheduled. 

3.  All  possible  graphics  are  scheduled. 


RESULTS  : 

CASE  1  . 

-  PASS: 

FAIL: 

DATE 

CASE  2  . 

-  PASS: 

FAIL: 

DATE 

CASE  3. 

-  PASS: 

FAIL  : 

DATE 

REMARKS  : 

3 


t 


TEST  PLAN  ADDITIONS  FOR  FOR  A  D15MS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2.3  -  Create  output  files  of  statistical  and 
graphical  analysis  data. 


TEST  CASES: 

1.  No  s t a t i s t i c a l / g r a p h i c a  1  analysis  is  requested. 

2.  Some  statistical/graphical  analysis  is  requested. 


EXPECTED  RESPONSE: 

1.  No  output  files  are  created. 

2.  A  statistical/graphical  output  file  is  created. 


RESULTS  : 

CASE  1.  -  PASS: _  FAIL: _  DATE: 

CASE  2.  -  PASS:  FAIL:  DATE: 


REMARKS : 


TEST  l'LAN  additions  fok  for 


PERFORMANCE  MONITOR 


QUIRE M ENT:  4.4  -  Display  graphical  presentations  of  the 

ecified  performance  measurement  data. 


ST  CASES: 

1.  No  graphical  representation  was  requested. 

2.  One  graphical  representation  was  requested. 

3.  All  possible  graphics  were  requested. 


PECTED  RESPONSE: 

1.  No  graphics  are  displayed. 

2.  One  graphical  representation  is  availble  for  display 

3.  All  possible  graphics  are  availible  for  display. 


SULTS  : 

CASE  1. 
CASE  2. 
CASE  3. 


MARKS 


-  PASS 

-  PASS 

-  PASS 


FAIL 

FAIL 

FAIL 


DATE  : 
DATE  ; 
DATE  : 
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TEST  PLAN  ADDITIONS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  4.5.2  -  Allow  the  user  to  retrieve  performance 
reports  from  a  library. 

TEST  CASES: 

1.  No  retrieval  of  reports  is  requested. 

2.  Library  retrieval  is  requested. 

EXPECTED  RESPONSE: 

1.  No  report  retrieval  occurs. 

2.  A  performance  report  is  retrieved  from  the  library. 

RESULTS : 

CASE  1.  -  PASS: _  FAIL: _  DATE: _ 

CASE  2.  -  PASS:  FAIL:  DATE: 


REMARKS : 
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FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  4.5.3  -  Allow  the  user  to  delete  performance 

reports  from  a  library. 


TEST  CASES: 

L.  No  deletion  of  reports  is  requested. 
2.  Library  deletion  is  requested. 


EXPECTED  RESPONSE: 

[  Nq  report  de let  ion  occurs  • 

2.  A  performance  report  is  deleted  from  the  library 
RESULTS : 

CASE  1.  -  PASS: _  FAIL: _  DATE: - 

CASE  2.  -  PASS: _  FAIL: _  DATE: - 


REMARKS  : 
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TEST  PLAN  ADDITIONS  FOR  FOR  A  D  tiM  S  PERFORMANCE  MONITOR 


REQUIREMENT:  5.0  -  Have  all  operating  instructions  and 
procedures  in  a  comprehensive  user's  manual. 


TEST  CASES: 

1.  Manual  represents  all  the  operating  instructions  for 
the  performance  monitor. 

EXPECTED  RESPONSE: 

i .  The  manual  is  complete  in  its  coverage  of  monitor 
operations. 


RESULTS  : 

CASE  1.  -  PASS:  FAIL:  DATE: 


REMARKS : 
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System  Design  Documentation  -  Structure  Charts 


TabLe  of  Contents 


P 

Introduction . D 

User  Interface  Chart  Index . D 

User  Interface  Structure  Charts  .  D 

User  Interface  Data  Dictionary . ...D 


Instrumentation  Utility  Structure  Chart  Index  .  .  D 
Instrumentation  Utility  Structure  Chart  .  .  .  .  .  D 
Instrumentation  Utility  Data  Dictionary  .  D 


Data  Analysis  Program  Chart  Index  .  D 

Data  Analysis  Program  Sturcture  Charts  .  D 


Data  Analysis  Program  Data  Dictionary  .  D 


This  appendix  contains  the  program  documentation  for 
the  design  changes  made  during  the  course  of  this  study. 
The  program  documentation  consists  of  structure  charts  and 
data  dictionaries.  Structure  chart  entries  marked  with  * 
refer  the  reader  to  reference  2.  Structure  chart  entries 
marked  with  *  *  refer  to  reference  5. 
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Chart  Index 


0.0  USER  INTERFACE 


1.0  INITIALIZE  DATE  TABLE 


2.0  DISPLAY  WELCOME  SCREEN 


3.0  DISPLAY  MENU 


3.1  MAIN  MENU 


3.1.1  ESTABLISH  MEASUREMENT  SESSION 

3.1.2  SHOW  SESSION  STATUS 

3.1.3  DELETE  MEASUREMENT  SESSION 

3.1.4  DISPLAY  MEASUREMENT  DATA 

3. 1.4.1  DISPLAY  SESSION  INFORMATION 

3. 1.4. 2  DISPLAY  MEASUREMENT  REPORT 

3. 1.4. 3  DISPLAY  STATISTICAL  ANALYSIS 

3. 1.4. 3.1  GET  STATISTICAL  FILES 

3. 1.4. 3. 2  PERFORM  STATISTICAL  ANALYSIS 


3. 1.4. 4  DISPLAY  MEASUREMENT  GRAPHICS 

3. 1.4. 4.1  GET  GRAPHICAL  FILES 

3. 1.4. 4. 2  PERFORM  GRAPHICAL  ANALYSIS 

3. 1.4. 5  PERFORM  REPORT  LIBRARY  OPERATIONS 

3 . 1  .4 .5  . 1  STORE  REPORT 

3. 1.4. 5. 2  RETRIEVE  REPORT 

3. 1.4. 5. 3  DELETE  REPORT 


3.1.5  EXIT  PROGRAM 


4.0  GET  MENU  SELECTION 


USER  INTERFACE 


DISPLAY  MENU 


DISPLAY  HE MU 
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TYPE :  P  ROCESS 

DATE:  6  AUG  1985 

NUMBER:  0.0 

NAME:  DBMON  USER  INTERFACE 

INPUT  DATA:  USERS  ELECTION 
INPUT  FLAGS:  None 

OUTPUT  DATA:  DATE  TABLE,  NAME,  HAXSELECTION 
OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  is  the  user  interface  for  the 

data  base  performance  monitor.  It  establishes  the 
performance  measurement  session,  shows  the  status  of  the 
session,  allows  changes  to  the  measurement  session,  and 
analyzes  the  measurement  data. 

ALIASES:  None 

RELATED  SADT  NUMBER:  AO 

CALLING  PROCESSES:  None 

PROCESSES  CALLED:  1.0,  2.0,  3.0,  4.0 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.0 

NAME:  INITIALIZE  DATE  TABLE 

INPUT  DATA:  DATE  TABLE 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  initializes  the  date  table  used 

for  the  editing  of  month  and  day  values. 

ALIASES:  None 

RELATED  SADT  NUMBER:  All 
CALLING  PROCESSES:  0-0 
PROCESSES  CALLED:  None 
FILES  READ:  None 
FILES  WRITTEN :  None 
HARDWARE  READ:  None 
HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  2.0 

NAME:  DISPLAY  WELCOME  SCREEN 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

CLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  the  initial  screen  for 

the  data  base  performance  monitor  user  interface. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A1 

CALLING  PROCESSES:  0.0 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.0 

NAME:  DISPLAY  MENU 

INPUT  DATA:  NAME 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  a  menu  to  the  user  of 

the  data  base  performance  monitor. 

ALIASES:  None 

RELATED  SADT  NUMBER:  Alb 
CALLING  PROCESSES:  0.0 
PROCESSES  CALLED:  3.1 
FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 
HARDWARE  WRITTEN:  Terminal 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  4.0 

NAME:  GET  MENU  SELECTION 

INPUT  DATA:  MAXSELECTION 

INPUT  FLAGS:  None 

OUTPUT  DATA:  U S E RS E L E C T I  ON 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  reads  and  edits  user  menu 

selections. 

ALIASES:  None 

RELATED  SADT  NUMBER:  All 

CALLING  PROCESSES:  0.0 

PROCESSES  CALLED:  See  Reference  2 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.1 

NAME:  MAIN  MENU 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  the  top  level  menu  for 

the  data  base  performance  monitor  user  interface. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A1 

CALLING  PROCESSES:  3.0 

PROCESSES  CALLED:  3.1.1,  3.1.2,  3.1.3,  3.1.4,  3.1.5 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 


S 


j*.  'A  A:m'AV.W.W 


V  V." 


( 


SYSTEM  DESIGN  DOCUMENTATION  -  STRUCTURE  CHARTS 

TYRE:  PROCESS 

DATE:  6  AUG  198  5 

NUMBER :  3  . I  - L 

NAME:  ESTABLISH  MEASUREMENT  SESSION 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  allows  the  user  to  establish  the 

data  base  performance  monitor  session. 

ALIASES:  None 

RELATED  SAUT  NUMBER:  A2 

CALLING  PROCESSES:  3.1 

PROCESSES  CALLED:  See  Reference  2 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.1.2 

NAME:  SHOW  SESSION  STATUS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  the  status  of  the 

current  measurement  session  to  the  monitor  user. 

ALIASES:  None 

RELATED  SADT  NUMBER:  Al 

GALLING  PROCESSES:  3.1 

PROCESSES  CALLED:  See  Reference  5 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  3-1-3 

NAME:  ESTABLISH  MEASUREMENT  SESSION 

INPUT  DATA:  None 

INPUT  PLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  allows  the  user  to  delete  the 

current  data  base  performance  monitor  session. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A1 

CALLING  PROCESSES:  3.1 

PROCESSES  CALLED:  See  Reference  5 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.1.4 

NAME:  DISPLAY  MEASUREMENT  DATA 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  MEASUREMENT  DATA 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  allows  the  user  to  analyze  and 

display  performance  measurement  data. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 

CALLING  PROCESSES:  3.1 

PROCESSES  CALLED:  3. 1.4.1,  3. 1.4. 2,  3. 1.4. 3,  3. 1.4. 4, 

3  .  1  . 4 . 5 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 
HARDWARE  WRITTEN:  Terminal 
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TYRE :  PROCESS 

DATE:  6  AUC  1935 

NUMBER:  3.1.5 

NAME:  EXIT  PROGRAM 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  ends  execution  of  the  data  base 

performance  monitor  user  interface. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A1 

CALLING  PROCESSES:  3.1 

PROCESSES  CALLED:  See  Reference  2 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3. 1.4.1 

NAME:  DISPLAY  SESSION  INFORMATION 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA*.  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  information  about  the 

current  monitor  session. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 
CALLING  PROCESSES:  3.1.4 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN :  None 
HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 
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TYRE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  3  .  1  .4 .2 

NAME:  DISPLAY  MEASUREMENT  REPORT 

INPUT  DATA:  MEASUREMENT  DATA 

INPUT  ELACS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  produces  and  displays  the 

consolidated  data  base  performance  measurement  report. 

AL  IASES  :  None 

RELATED  SADT  NUMBER:  A4 

CALLING  PROCESSES:  3.1.4 

PROCESSES  CALLED:  See  Reference  5 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  3  .  1  .4 .3 

NAME:  DISPLAY  S T AT  I S T I C A L  AN AL Y S I S 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  generates  and  displays  the 

statistical  analysis  of  performance  measurement  data. 

ALIASES:  Instrument  Statistics 

RELATED  SADT  NUMBER:  A32 

CALLING  PROCESSES:  3.1.4 

PROCESSES  CALLED:  3. 1.4. 3.1,  3. 1.4. 3. 2 

FILES  READ:  STATISTICAL  ANALYSIS  FILES 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 
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TYRE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.1  .4.4 

NAME:  DISPLAY  MEASUREMENT  GRAPHICS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  generates  and  displays  the 

graphical  presentation  of  measurement  data  to  the  user. 

ALIASES:  Instrument  Graphics 

RELATED  SADT  NUMBER:  A32 

CALLING  PROCESSES:  3.1.4 

PROCESSES  CALLED:  3. 1.4. 4.1 

FILES  READ:  GRAPHICAL  ANALYSIS  FILES 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3.1  .4.5 

NAME:  PERFORM  REPORT  LIBRARY  OPERATIONS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  allows  the  user  to  establish  the 

data  base  performance  monitor  session. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A42 

CALLING  PROCESSES:  3.1.4 

PROCESSES  CALLED:  3. 1.4. 5.1,  3. 1.4. 5. 2,  3. 1.4. 5. 3 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 
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TYRE:  PROCESS 

DATE:  6  AUG  1985 

NUM3ER:  3 . 1  .4 .3  .  1 

NAME:  CETSTATF1LENAME 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATF1LENAME 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  gets  the  name  of  a  statistical 

file  to  be  used  in  statistical  analysis. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A32 
CALLING  PROCESSES:  3. 1.4. 3 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3  .  1  .4 .3  .2 

NAME:  PERFORM  STATISTICS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  Hone 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  performs  the  requested 

statistical  analysis. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A32 

CALLING  PROCESSES:  3. 1.4. 3 
PROCESSES  CALLED:  None 

FILES  READ:  STATISTICAL  FILES 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  3  •  1  .4 .3 .2  . 1 

NAME:  GET  CRITICAL  VALUE 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  CRITICAL  VALUE 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  computes  the  critical  value  C 

used  in  the  Wilcoxon  Rank-Sum  Test. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A32 

CALLING  PROCESSES:  3. 1.4. 3.  2 

PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3. 1.4. 3- 2. 2 

NAME:  COMPUTE  W  STATISTIC  . 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  W  STATISTIC 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  computes  the  W  value  used  in  the 

Wilcoxon  P.  a  n  k  -  S  u  m  Test. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A32 
CALLING  PROCESSES:  3. 1.4. 3. 2 

PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN :  None 

HARDWARE  READ:  .  None 
HARDWARE  WRITTEN:  None 
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TYRE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3 . 1  .4  .4  .  I 

NAME:  DISPLAY  GRAPHICS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  the  graphical  files  as 

bar  graph  upon  the  user's  terminal. 

AL  I  AS  E  S  :  None 
RELATED  SADT  NUMBER:  A3  2 

CALLING  PROCESSES:  3. I. 4. 4 
PROCESSES  CALLED:  None 

FILES  READ:  GRAPHICAL  FILES 

FILES  WRITTEN:  None 

HARDUARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

HUMBER:  3. 1.4. 5.1 

NAME:  STORE  REPORT 

INPUT  DATA:  PERFORMANCE  REPORT 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  stores  measurement  reports  into 

the  performance  report  library. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 2 1 

CALLING  PROCESSES:  3. 1.4. 5 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Hone 

HARDWARE  WRITTEN:  None 


SYSTEM  DESIGN  DOCUMENTATION 


STRUCTURE  CHARTS 


TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  3 . 1  .4 .5  .2 

NAME:  RETRIEVE  REPORT 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  PERFORMANCE  REPORT 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  retrieves  the  requested 

performance  report  from  the  performance  report  library. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 2 2 

CALLING  PROCESSES:  3. 1.4. 5 

P  ROCESSES  CALLED :  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  Terminal 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3. 1.4. 5. 3' 

NAME:  DELETE  REORT 

INPUT  DATA:  PERFORMANCE  REPORT 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  deletes  the  specified  performance 

report  from  the  performance  report  library. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 2 3 

CALLING  PROCESSES:  3. 1.4. 5 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3 . 1  .4 .5  .4 

NAME:  GETREPORTFILENAM 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  REPORTFIL 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  N 

DESCRIPTION:  This  proc 

report  from  the  user. 
ALIASES:  None 

RELATED  SADT  NUMBER:  A' 
CALLING  PROCESSES:  3.1 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Termina 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3. 1.4. 5. 5 

NAME:  CETREPORTNAME 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  REPORTNAM 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  N 
DESCRIPTION:  This  proc 


ALIASES:  None 

RELATED  SADT  NUMBER:  A 
CALLING  PROCESSES:  3.1 
PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Termina 
HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3 . 1  . A  .  5  •  6 

NAME:  GETREPORTD  AT  E 
INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  REPORTDATE 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  gets  the  report  date  from  the 

user. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4  2 

CALLING  PROCESSES:  3.1. A. 5.1,  3. 1.4. 5. 2,  3. 1.4. 5. 3 

PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  3  . 1  .4  .  5  .  7 

NAME :  CETNEWREPORTFILENAME 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  N E W R E P 0 RT F I L E N AM E 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  gets  the  new  report  file  name 

from  the  user. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A4 2 

CALLING  PROCESSES:  3. 1.4. 5. 3 

PROCESSES  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  None 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  CRITICAL  VALUE 

PASSED  FROM:  3. 1.4. 3.  2.  2 

PASSED  TO :  3 . 1  .4  .3  .2 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  Is 

the  Wilcoxon  Rank-Sum  Test. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Numeric 

VALUES:  1  to  maximum  value  of 

RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 


statistical  value  used 


statistic 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  DATE  TABLE 

PASSED  FROM:  0-0 

PASSED  TO:  1.0 

COMPOSITION  :  N/A 

DESCRIPTION:  This  parameter  is  used  to  edit  the  day  and 

month  inputs  from  the  user. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Array 

VALUES:  Numeric,  String 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  GRAPHICAL  FILES 

PASSED  FROM:  3.  1.4. 4.1,  3. 1.4. 4 

PASSED  TO:  3. 1.4. 4,  3. 1.4. 4. 2 

COMPOSITION:  M/A 

DESCRIPTION:  This  parameter  consists  of  raw  graphical  files 

ready  for  graphical  analysis. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  GRAPHICAL  ANALYSIS  FILES 
STORAGE  TYPE:  Global 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  MAXSELECT ION 

PASSED  FROM:  0.0 
PASSED  TO:  4.0 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  maximum  number  of 

selections  allowed  for  a  particular  menu. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Character 

VALUES:  1  to  maximum  number  of  menu  selections 

RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1935 

NAME:  MEASUREMENT  DATA 

PASSED  FROM:  3.1.4,  3.  1.4.1,  3. 1.4. 2 

PASSED  TO:  3  .  1  .4  .  1  ,  3  .  1  .4 .2 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  performance  measurement 

data  produced  by  a  measurement  session  of  the  monitor. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 

VALUES:  Character,  Numeric 

c  t ions 

RELATED  SADT  ELEMENTS:  MEASUREMENT  DATA  FILES 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  NAME 

PASS  CD  FROM :  0.0 

PASSED  TO:  3.0 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  the  next  menu  to 

be  displayed  on  the  terminal. 

ALIASES:  Hone 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Scaler 

VALUES:  MENUNAME 

RELATED  SADT  ELEMENTS:  NEXT  SCREEN  FORMAT 

STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  NEWREPORTF I  LENA ME 

PASSED  FROM:  3  .1  .4.5.7 
PASSED  TO:  3  .  1  .4 .5  -3 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  a  file  that  i 

to  contain  a  report. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 
VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

S TO  RACE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  PERFORMANCE  REPORT 

PASSED  FROM:  3.1.4 

PASSED  TO :  3 . 1 .4 . 5 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  any  of  the  performance 

measurement  reports  produced  by  the  monitor. 

ALIASES:  Hone 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 
VALUES:  Character,  Numeric 

RELATED  SADT  ELEMENTS:  PERFORMANCE  MEASUREMENT  REPORT 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  REPORTUATE 

PASSED  FROM :  3  .  1  .4 . 5  .6 

PASSED  TO:  3. 1.4. 5.1,  3. 1.4. 4. 2,  3.  1.4. 5. 3 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  date  of  a  performance 

report  . 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 
VALUES:  Character,  Numeric 

RELATED  SADT  ELEMENTS:  None 

IS  FILES 

STORAGE  TYPE:  Passed 
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TYPE :  PARAMETER 

DATE:  6  AUG  1985 

NAME:  REPORTF I  LENA ME 

PASSED  FROM  :  3 •  1  .4 . 5  .4 

PASSED  TO:  3 .1 .4 .5 . 1 

COMPOSITION:  N/ A 

DESCRIPTION:  This  parameter  is  a  name  of  a  file  that 

contains  a  performance  report. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


DATE:  6  AUG  1985 

NAME:  REPORTNAME 

PASSED  FROM:  3  .  1  .4  .5  .5 

PASSED  TO:  3. 1.4. 5.1,  3. 1.4. 5. 2,  3. 1.4. 5. 3 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  title  of  a  performance 

report. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  SESSION  DATA 

PASSED  FROM :  3.1.4 

PASSED  TO:  3. 1.4.1 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  session  specifications 

obtained  from  the  monitor  user. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 

VALUES:  Character,  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 
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TYRE:  RARAMETER 

DATE:  6  AUC  1985 

NAME:  W  STATISTIC 

PASSED  FROM:  3 . 1  .9  .3  .2  .2 

PASSED  TO:  3.1  .4 .3  .2 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  a  statistical  value  used  in 

the  Wilcoxon  Rank-Sum  Test. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Numeric 

VALUES:  1  to  maximum  value. 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Clobal 
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Instrumentation  Utility  Chart  Index 


1  .0  INITUTILITY 


2.0  END MEASURE 


3-0  MEASUREDBMS 


4.0  FINDPID 


5.0  E ILEHANDLER 


6.0  CETDATA 
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TYRE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  1.0 

NAME:  INITUTILITY 

INPUT  DATA:  PROGRAMNAME,  D ATAB AS E NAME ,  DBMSNAME 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATUS 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  DBUFF,  UTILSTAT 

GLOBAL  DATA  CHANGED:  DBUFF,  UTILSTAT 

DESCRIPTION:  This  process  is  the  entry  point  for  using  the 

instrumentation  utility.  It  enables  the  utility  by  finding 
the  DBMS's  process  id,  creating  a  data  file,  and  recording 
the  calling  program  name  and  data  base  name. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A23 

CALLING  PROCESS:  None 

PROCESS  CALLED:  4.0,  5.0 

FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 

* 

TYPE :  P  ROCESS 

DATE:  6  AUG  1985 

NUMBER:  2.0 

NAME:  ENDMEASURE 

INPUT  DATA:  ENDCODE 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATUS 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  DBUFF,  UTILSTAT,  FLCODE 

GLOBAL  DATA  CHANGED:  DBUFF,  UTILSTAT,  FCODE 

DESCRIPTION:  This  process  records  the  state  of  the  DBMS 

after  a  DBMS  command  has  been  executed. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A24 

CALLING  PROCESS:  None 

PROCESS  CALLED:  5.0,  6.0 
FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  J.O 

NAME:  MEASUREDBMS 

INPUT  DATA:  D BMS FU HCT I  ON ,  DBMSF ILENAME 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATUS 

OUTPUT  FLAGS:  None 

CLOBAL  DATA  USED:  DBUFF,  UTILSTAT 

CLOBAL  DATA  CHANGED:  DBUFF,  UTILSTAT 

DESCRIPTION:  This  process  records  the  status  of  the  DBMS 

just  before  the  execution  of  a  DBMS  command. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A24 

CALLING  PROCESS:  None 

PROCESS  CALLED:  6.0 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  4.0 

NAME:  FINDPID 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  PIDSAVE,  DBMSNAME,  UTILSTAT 

GLOBAL  DATA  CHANGED:  PIDSAVE 

DESCRIPTION:  This  process  searches  the  list  of  active 

process  to  find  the  pid  of  the  DBMS  that  is  being  measured 
by  the  monitor  instu mentation  utility. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A24 

CALLING  P  ROCESS :  1.0 

PROCESS  CALLED:  7.0 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  5.0 

NAME:  FILEHANDLER 

INPUT  DATA:  FLCODE 

INPUT  FLACS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

CLOBAL  DATA  USED:  UTILSTAT 

GLOBAL  DATA  CHANGED:  UTILSTAT 

DESCRIPTION:  This  process  handles  all  operations  related  to 

the  output  of  the  instrument  data  file. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A24 

CALLING  PROCESS:  1.0,  2.0,  7.0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  l NST KUME NATAT I  ON  DATA  FILE 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  6.0 

NAME:  GETDATA 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  PIDSAVE,  UTILSTAT 

GLOBAL  DATA  CHANGED:  UTILSTAT 

DESCRIPTION:  This  process  retrieves  the  performance  data 

from  the  system  tables. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A24 

CALLING  PROCESS:  2.0,  3.0 
PROCESS  CALLED:  7.0 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  7.0 

NAME:  SSERROR 

INPUT  DATA:  SYSTEM  ERROR  CODES 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  FLCODE ,  UTILSTAT 

GLOBAL  DATA  CHANGED:  FLCODE,  UTILSTAT 

DESCRIPTION:  This  process  handles  error  conditions  returned 

by  system  routines. 

ALIASES :  None 

RELATED  SADT  NUMBER:  A24 
CALLING  PROCESS:  4.0,  6.0 
PROCESS  CALLED:  5-0 
FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  DATABASENAME 

PASSED  FROM:  Calling  Program 

PASSED  TO :  l .0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  the  data  base 

being  accessed  by  the  application  program  being  monitored. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  DBMSFILENAME 

PASSED  FROM:  Calling  Program 

PASSED  TO:  3.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  the  file  within 

the  DBMS  that  is  being  accessed  by  the  application  program. 
ALIASES:  None 

PART  OF:  H/A 

DATA  CHARACTERISTICS:  String 
VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  DBMS  FUNCTION 

PASSED  FROM:  Calling  Program 

PASSED  TO:  3.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  the  DBMS  command 

that  is  being  measured. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  DBMS  NAME 

PASSED  FROM:  Calling  Program 

PASSED  TO  :  1.0 

COMPOSITION :  N/ A 

DESCRIPTION:  This  parameter  is  the  name  o£  the  DBMS  that 

being  monitored. 

ALIASES:  None 

PART  OF:  M/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  ENDCOUE 

PASSED  FROM:  Calling  Program 

PASSED  TO:  2.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  indicates  if  the 

instrumentation  utility  is  to  be  disabled  or  not. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  ERROrXODE 

PASSED  FROM:  4.0,  5.0 

PASSED  TO:  7.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  of  the  error  that 

has  occured. 

ALIASES:  Hone 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  Hone 

STORAGE  TYPE:  Global 


‘,.S  s 


SYSTEM  DESIGN  DOCUMENTATION  -  STRUCTURE  CHARTS 


TYRE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  ELCODE 

PASSED  FROM :  1.0,  2  . 

PASSED  TO:  5.0 
COMPOSITION:  N/A 

DESCRIPTION:  Tl»  is  pa 

file handler  process. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS: 
VALUES:  Character 

RELATED  SADT  ELEMENTS 
STORAGE  TYPE:  Global 


parameter  is  the  function  code  for  the 


String 


TYPE:  PARA 

DATE:  6  AU 

NAME:  PIDS 

PASSED  FROM 
PASSED  TO: 
COMPOSITION 


PARAMETER 
6  AUG  1985 
PIDSAVE 
FROM:  1  .0 

TO :  4.0 

TION:  N/A 


DESCRIPTION:  This  pa 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS: 
VALUES:  Character 

RELATED  SADT  ELEMENTS 
STORAGE  TYPE:  Global 


parameter  is 


String 


process 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  PROGRAMNAME 

PASSED  FROM:  Calling 

PASSED  TO :  1.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  pa 

application  program. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS: 
VALUES:  Character 

RELATED  SADT  ELEMENTS 
STORAGE  TYPE:  Global 


Calling  Program 
1  .0 
N/A 

This  parameter  is  name  of  the  calling 
prog  ram . 


String 
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TYRE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  STATUS 

PASSED  FROM:  1.0,  2.0,  3.0 

PASSED  TO:  Calling  Program 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  indicates  the  status  of  the 

previous  instrumentation  utility  operation. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  UTILSTAT 

PASSED  FROM:  4.0,  5.0,  6.0,  7.0 

PASSED  TO:  1.0,  2.0,  3.0,  4.0,  6.0,  7.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  current  status  of  the 

instrumentation  utility. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Global 
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Data  Analysis  Program  Chart  Index 

L.O  MAIN  DRIVER 

I . I  DISPLAY  MENU 
1  . 2  CHEAT ELISTS 

1.3  INITBUFF 

1.4  INIT TABLE 

1  .5  DAT  AINTABLE 

1 .6  INITSTATISTICS 

1 . 7  CREATETABLE 

L . 8  SESSIONTOTALS 

1.9  PROCESSRAWDATA 

1.9.1  READRECORD. 

1.9.2  LOOKUP 

1.9.3  CONPUTEVALUES 

1.10  P  RI NTSUMMARY 

1.11  COMP  UTEG  RAP  11DATA 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  1 .0 

NAME:  MAIN  DRIVER 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  is  the  main  driver  for  the  data 

analysis  program. 

AL I ASES :  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS:  None 

PROCESS  CALLED:  1.1,  1.2,  1.3,  1.4,  1.5,  1.6,  1.7,  1.8, 

1.9,  1.10,  1.11 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.1 

NAME:  DISPLAY  MENU 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  SELECTION 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  displays  the  main  menu  of  the 

data  analysis  program. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 
CALLING  P  ROCESS :  l  .0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  Terminal 

HARDWARE  WRITTEN:  Terminal 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.2 

NAME:  C  RE ATE  LISTS 

INPUT  DATA:  RETRIEVE,  STORAGE,  CONTROL,  SPECIALPURP 

INPUT  FLAGS:  None 

OUTPUT  DATA:  RETRIEVE,  STORAGE,  CONTROL,  SPECIALPURP 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  creates  four  lists  of  DHL 

commands  based  on  their  type. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 
CALLING  PROCESS:  1.0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.3 

NAME:  1NITBUFF 

INPUT  DATA:  DBUFF 

INPUT  FLAGS:  None 

OUTPUT  DATA:  DBUFF 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  initializes  the  contents  of 

DML  data  buffer  to  zero. 

ALIASES  :  None 

RELATED  SADT  NUMBER:  A3 
CALLING  PROCESS:  1.0 
PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.4 

NAME:  INI  TAB  LE 

INPUT  DATA:  TABLE 

INPUT  FLACS:  None 
OUTPUT  DATA:  TABLE 
OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  initializes  the  DHL  data  table  to 

zero. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 
CALLING  PROCESS :  1  .0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.5 

NAME:  DATAINTABLE 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  Boolean  value  of  true  or  false 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  PRGINFO,  INVINFO 
GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  determines  if  a  table  is  empty  or 

not. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 
CALLING  PROCESS :  1  .0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 
HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYRE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1 .6 

NAME:  INITSTATISTICS 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATISTICAL  FILES 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  initializes  the  statistical  files 

if  requested. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS:  1.0 
PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  1.7 

NAME:  CREATETABLE 

INPUT  DATA:  None 

INPUT  FLAGS:  None 

OUTPUT  DATA:  TABLE 

OUTPUT  FLAGS:  None 

CLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  creates  a  table  of  DML  commands. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  P  ROCESS  :  1.0 

PROCESS  CALLED:  See  Reference  1 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYRE:  RROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.8 

NAME:  SESS ION TOTALS 

INPUT  DATA:  PRCINFO,  INVINFO 

INPUT  FLAGS:  None 

OUTPUT  DATA:  SUMINFO,  SUMINVINFO 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  accumulates  overall  totals  for 

the  measurement  session. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

GALLING  PROCESS:  1  .0 

PROCESS  GALLED:  See  Reference  1 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1.9 

NAME:  PROCESSRAWDATA 

INPUT  DATA:  PRCINFO,  INVINFO 

INPUT  FLAGS:  None 

OUTPUT  DATA:  STATISTICAL  FILES,  GRAPHICAL  FILES, 


INPUT  FLAGS:  None 

OUTPUT  DATA:  STATISTICAL  FILES,  GRAPHICAL  FILES, 

CURRPRGNAME,  D  FLAG 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  controls  the  reading  of  raw  data 

files  and  their  processing. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS :  1 .0 

PROCESS  CALLED:  1.9.1,  1.9.2,  1.9.3 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  1 . 10 

NAME:  PRINTSUMMARY 

INPUT  DATA:  PRGINFO,  INVINFO,  PROCNAME 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  prints  the  summary  report. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS:  1  .0 

PROCESS  CALLED:  See  Reference  1 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 


TYPE:  PROCESS 

DATE:  6  AUG  1985 

NUMBER:  1  .  1  l 

NAME:  C  OMP  UTEG  RAP  HD AT  A 

INPUT  DATA:  GRAPHICAL  FILES 

INPUT  FLAGS:  None 

OUTPUT  DATA:  GRAPHICAL  FILES 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

CLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  configures  the  graphical  data 

into  a  form  required  by  the  graphical  analysis  program. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS :  1  .0 

PROCESS  CALLED:  None 

FILES  READ:  None 

FILES  WRITTEN:  None 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYRE :  PROCESS 

DATE:  6  AUC  1985 

NUMBER:  1.9.3 

NAME:  COMPUTEVALUES 

INPUT  DATA:  RAUVALS 

INPUT  FLAGS:  None 

OUTPUT  DATA:  None 

OUTPUT  FLAGS:  None 

GLOBAL  DATA  USED:  None 

GLOBAL  DATA  CHANGED:  None 

DESCRIPTION:  This  process  computes  the  values  of  the 

performance  parameters  and  records  them  in  the  statistical 
and  graphical  files. 

ALIASES:  None 

RELATED  SADT  NUMBER:  A3 

CALLING  PROCESS:  1 .9 

PROCESS  CALLED:  See  Reference  1 

FILES  READ:  None 

FILES  WRITTEN:  STATISTICAL  FILES,  GRAPHICAL  FILES 

HARDWARE  READ:  None 

HARDWARE  WRITTEN:  None 
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TYPE:  PARAMETER 

DATE:  6  AUC  1983 

NAME:  CONTROL 

PASSED  PROM:  t  .0  ,  1  . 

PASSED  TO:  1.2 

COMPOS n ION :  N/A 

DESCRIPTION:  This  pa 

commands  . 

ALIASES:  None 

PART  OK:  N/A 

DATA  CHARACTERISTICS  : 
VALUES:  Character 

RELATED  SADT  ELEMENTS 
STORAGE  TYPE:  Passed 


pa  r ame  ter  is 


Array 


control 


TYPE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  CMPVALS 

PASSED  FROM:  1.9.3 
PASSED  TO:  1.9 

COMPOSITION :  N/ A 

DESCRIPTION:  This  parameter  is  computed  performance  data 

ALIASES:  None 

PART  OK:  N/A 

DATA  CHARACTERISTICS:  Record 
VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARA 

DATE:  6  AU 

NAME:  CURR 

PASSED  FROM: 
PASSED  TO: 
COMPOS  I T ION 
DESCRIPTION 


PARAMETER 
6  AUC  1985 
C  U  RRP  RC  NAME 


1  .9 
1  .0 
N/A 

This  parameter  is  the  name  of  the  DBMS 
program  that  is  currently  being  evaluated 


application  program  that  is  ci 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 
VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


ill 
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TYRE :  PARA 

DATE:  6  AU 

NAME:  DATA 

PASSED  FROM 
PASSED  TO: 
COMPOSITION 


PARAMETER 
6  AUG  1985 
DATAREC 
FROM :  1.9.1 

TO:  1.9 

TION:  N/A 


DESCRIPTION:  This  parameter  is  a  record  of  raw  data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  DUUFF 

PASSED  FROM :  1.0,  1 . 

PASSED  TO:  1.3 

COMPOSITION:  N/A 

DESCRIPTION:  This  pa 

ALIASLS:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS: 
VALUES:  Character 

RELATED  SADT  ELEMENTS 
STORAGE  TYPE:  Passed 


parameter  is 


Array 


data  buffer  area 


TYPE  : 
DATE  : 
NAME  : 
PASSED 


P ARAME 
6  AUG 
D  FLAG 
FROM  : 


PASSED  TO:  1 

COMPOS  I T ION : 
DESCRIPTION: 


1.9.1 

9 

N/A 

This  parameter  indicates  end  of  file  for  the 


raw  measurement  data  file. 
ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Int 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  No 

STORAGE  TYPE:  Passed 


Integer 
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TYPE:  PARAMETER 

DATE:  6  AUC  1985 

NAME:  GRAPHICAL  FILES 

PASSED  FROM:  1.0,  1.9.3,  1.11 

PASSED  TO :  1.0,  1.9.3 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  file  of  graphical  data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  GRAPHICAL  ANALYSIS  FILES 

STORAGE  TYPE:  Global 


TYPE:  PARAMETER 

DATE:  6  AUC  1935 

NAME:  I  MV  INFO 

PASSED  FROM :  1.0 

PASSED  TO:  1.5,  1.8,  1.9,  1.10 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  DHL  performance  data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 

VALUES:  Numeric 

RELATCU  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  LOOKUP 

PASSED  FROM:  1.9.2 

PASSED  TO:  1.9 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  location  of  an  item  in  a 

table. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Integer 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  PROGNAME 

PASSED  FROM:  1 .0 

PASSED  TO:  1.11 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  name  o£  the  program 

whose  data  is  to  be  printed. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  String 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  PRGINFO 

PASSED  FROM:  1  .0 

PASSED  TO:  1.5,  1.8,  1.9,  1.10 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  DHL  performance  data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  RAWVALS 

PASSED  FROM :  1.9 

PASSED  TO:  1.9.3 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter 

data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 

VALUES :  Nume  r  ic 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


1.9.3 

N/A 

This  parameter  is  a  record  of  raw  performance 
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TYPE:  PARAMETER 

DATE:  6  AUG  1935 

NAME:  RETRIEVE 

PASSED  FROM:  1.0,  1.2 

PASSED  TO:  1.2 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  a  the  list  of  DML  retrieva 

commands. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Array 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  SELECTION 

PASSED  FROM:  1.1 

PASSED  TO:  1.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  user  menu  selection. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Integer 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  SPECIALPURP 

PASSED  FROM:  1.0,  1.2 

PASSED  TO :  1.2 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  a  list  of  DML  special 

purpose  commands. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Array 
VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1935 

NAME:  STATISTICAL  FILES 

PASSED  FROM:  1.0,  1.6,  1.9,  1.93 

PASSED  TO:  1.6,  1.9.3 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  file  containing  data  to 

be  used  for  statistical  analysis. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  File 

VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Global 


(• 


TYPE:  PARAMETER 

DATE:  6  AUG  1935 

NAME:  STORAGE 

PASSED  FROM:  1  .0 ,  1  .2 

PASSED  TO:  1  .2 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  a  the  list  of  DML  storage 

command  s . 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Array 

VALUES:  Character 

RELATED  SADT  ELEMENTS:  None 

STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  SUMINVINFO 

PASSED  FROM:  1.8 
PASSED  TO :  1.0 

COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  totaled  performance 

data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 
VALUES:  Numeric 

RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  SUM  INFO 

PASSED  FROM:  1 . 8 
PASSED  TO:  1.0 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  the  summary  record  of 

performance  data. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 
VALUES:  Numeric 
RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 


TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  TABLE 

PASSED  FROM:  1.0,  1.4 

PASSED  TO:  1.0,  1.4 

COMPOSITION:  TABLEITEM 

DESCRIPTION:  This  parameter  is  a  table  of  DML  commands. 

ALIASES:  None 

PART  OF:  N/A 

DATA  CHARACTERISTICS:  Record 
VALUES:  Numeric 
RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 
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TYPE:  PARAMETER 

DATE:  6  AUG  1985 

NAME:  TABLEITEM 

PASSED  FROM:  1.8 
PASSED  TO:  1.0 
COMPOSITION:  N/A 

DESCRIPTION:  This  parameter  is  an  entry  in  a  DML  command 

table. 

ALIASES:  None 

PART  OF:  TABLE 

DATA  CHARACTERISTICS:  Record 
VALUES:  Numeric 
RELATED  SADT  ELEMENTS:  None 
STORAGE  TYPE:  Passed 


D  -  5  7 


s. 


*.  /, 


'7  ?  1  !•  ^  JL*  j-’ >>  V>  '»>  .•■  ’.V  :mv.%  .V.TVJV.VATVA'.V. 


v:iV« 


Instrument  Data  Statistics 


Performing  Report  Library  Operations 
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ANALDATA  Operational  Instructions 
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Use  of  the  Instrumentation  Utility 
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DBMON  User's  Methodology 
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Experimental  Procedures 
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Int  roiluc  t  Lon 


TIiLs  appendix  contains  the  DBM  ON  User's  Guide.  It 
presents  the  required  setup  for  using  DBM ON,  and  the 
operating  instructions  for  the  operation  of  DBMON,  Version 
3.0.  The  use  of  the  monitor  is  also  explained  as  part  of 
the  DBMON  User's  Methodology,  which  can  be  applied  to  help 


solve  DBMS  performance  problems. 


SECTION  I 


DBMON  SYSTEM  DESCRIPTION 


'V. 
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Scope 

The  scope  of  this  user's  guide  is  limited  to  describing 
the  operation  of  DBMON  software.  The  reader  should  have  a 
working  knowledge  of  the  VAX  11/780  computer,  the  VMS 
operating  system,  the  TOTAL  DBMS,  and  the  INGRES  DBMS.  For 
details  of  the  above,  consult  the  INGRES  reference  manual, 
TOTAL  reference  manual,  or  the  appropriate  VAX/VMS  manual. 

DBMON  Description 

DBMON  (Data  Base  Monitor)  is  a  Data  Base  Management 
System  Performance  Monitor.  It  is  designed  to  operate  with 
the  TOTAL  and  INGRES  DBMSs  on  a  VAX  11/780  computer  running 
the  VMS  operating  system. 

DBMON  ray  be  used  to  monitor  and  record  system  and 
performance  statistics  generated  by  DBMS  commands  embedded 
in  application  software.  DBMON  is  not  designed  for  use  with 
a  DBMS  that  is  being  used  interactively. 

The  DBMON  software  system  consists  of  four  VAX  VMS 
utilities  and  seven  programs  as  illstrated  in  Figure  E-l. 

VAX  utilities  are  marked  with  a  (U),  while  DBMON  programs 
are  marked  with  a  (P). 

Conceptually,  the  DBMON  system  may  be  broken  into  four 
functional  areas: 


V 

I 
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(1)  User  Interface.  The  user  interface  is  used  to  specify 
a  measurement  session.  A  measurement  session  is  the 
period  of  time  in  which  DBMON  will  be  collecting  DBMS 
performance  data.  The  DBMON  user  specifies  the  type  of 
performance  measurement  that  is  required.  The  user 
interface  uses  these  specifications  to  produce  a  VMS 
command  procedure  that  will  control  the  collection  of 
system  statistics  and  DBMON  execution. 

(2)  Measure  System  and  DBMS.  During  this  phase,  the  DBMON 
user  executes  an  application  program  that  has  embedded 
calls  to  the  instrumentation  facility  thereby  producing 
one  or  more  raw  measurement  files.  This  occurs  during  a 
measurement  session  initiated  by  the  User  Interface.  The 
instrumentation  facility  records  DBMS  performance 
statistics  while  the  system  utilities  are  used  to  record 
system  performance  parameters  specified  by  the  user. 

(3)  Analyze  Measurement  Data.  During  this  phase  the  raw 
data  collected  in  the  previous  phase  is  analyzed  and 
summarized.  VMS  utilities  are  used  to  extract  summarize 
the  required  performance  parameter  values  from  the  system 
accounting  and  error  log  files.  The  raw  measurement  files 
are  merged  into  a  single  file  which  is  analyzed  by  the 
Data  Analysis  Program. 


(  /* )  Present  Data. 


files 


DBM ON  Development  Status 

DBM ON  Version  3.0  is  a  complete  DBMS  performance 
monitor.  It  is  capable  of  providing  a  detailied  view  of  the 
operational  performance  of  the  TOTAL  and  INGRES  DBMSs. 


Installation  Re  quirements 

A  target  VAX  computer  for  the  DEMON  system  must  satisfy 
the  following  requirements: 


(1)  The  VMS  operating  system  must  be  used. 

(2)  The  Monitor,  Accounting,  and  SYE  utilities  must  be 
present . 

(3)  At  least  2000  blocks  of  availible  disk  space  is 
required. 

(4)  The  INGRES  DBMS  must  be  availible  for  DBM ON  use. 

(5)  A  separate  account  and  directory  must  be  established 
for  use  by  the  DBMON  system. 


U1C  Requirements 

The  DBMON  system  requires  system  priviliges.  This  is 
because  the  command  procedure  generated  by  the  user 
interface  must  access  the  error  log  files,  which  can  only  be 
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accessed  by  accounts  with  system  priviliges. 

There  is  also  a  UIC  requirement  assiciated  with  the 
instrumentation  utility.  The  utility  can  only  be  used  by 
those  users  with  system  priviliges,  or  by  those  users  with 
an  account  that  is  in  the  same  group  as  the  TOTAL  DBMS. 


DBM ON  Directory 

The  DU MON  directory  should  be  established  on  a  disk 
volume  separate  from  those  containing  the  TOTAL  and  I  N  C  R  E  S 
DBMSs.  This  will  avoid  the  additional  overhead  caused  by 
having  both  DBMON  and  the  target  DBMS  contending  for  the 
same  disk  drive.  The  UIC  of  the  DBMON  directory  should  be 
set  so  that  all  users  of  INGRES  and  TOTAL  have  access  for 
the  reading  and  writing  of  files  within  the  DBMON  directory 
It  is  recommended  that  the  DBMON  directory  be  in  the  same 
group  as  the  UIC  of  the  TOTAL  and  INGRES  DBMSs. 
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DBMON  Installati  o  n 

Wit u  the  creation  of  the  DBMON  account  and  directory, 
the  DBMON  software  may  be  loaded  from  the  BACKUP  tape  with 
the  following  VMS  commands: 


$  MOUNT/FOREIGN  <tdev-name>: 

$  3  A  C  K  U  P  <tdev-name> :DBMON.BAK/ SELECT =[  DBMON] 
<ddev-name> : ( DBMON] 


where  <tdev-name>  is  a  valid  tap  device  name,  and 
<ddev-name>  is  a  vaild  disk  device  name.  The  UIC  specified 
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should  be  the  same  as  the  U  l  C  the  DBMON  directory  was 
created  with. 

After  the  BACKUP  command  has  executed  the  following 
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files  should  be  present: 


ANALDATA. QP 
ANALYZE . TXT 
D  B  M  0  N  .  Q  P 
DBH0NINIT.COM 
INSTRMNT.TXT 
l NS  T  RUT  1  L . MAR 
L l B  RARY . TXT 
MAIN. TXT 
MEASURE .TXT 
MERCDATA.PAS 
PARAMETER.TXT 
PARMFILE  .  T  B  L 
P  RTREPORT . PAS 
SCREENLIB .PAS 
SESSION. LOG 
SETRUN . PAS 
SORTINSTR.COM 
STATS .TXT 


The  next  step  is  to  examine  DBMON.QP,  INSTRUTIL.MAR, 
SETRUN. PAS,  M ERG DATA. PAS ,  P RTREPORT . PAS ,  and  INSTRUTIL.MAR 
to  ensure  file  compatability.  Ln  the  DBMON.QP  file,  the 
program  constraints  shown  below  must  be  verified  to  ensure 
device  name  and  UIC  compatability. 


ERRORF ILES 
DATAF l LCS 
U  l  C  C  0  D  E 


’  D  U  AO : l SYSO.SYSERR]  '  ; 
'  DUA1  :  [  DBMON]  '  ; 

' [200 , 050 ] ' ; 


The  two  0  P  E  N ( )  statements  in  the  program  must  also  be 
verified  to  ensure  device  name  compatability. 

In  the  INSTRUTIL.MAR  program,  the  following  statement 


must  be  verified  to  ensure  device  name  compatability  for  the 
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DU  MON  directory. 

DATAFILE:  $  FAD  F N M  =  < D U A  1  :  [ DB MO N ]  I N ST R . D AT > , F AC= P U T 

In  the  ANALDATA.QP  program,  the  0PEN()  statements  must 
also  be  checked  lor  device  name  comparability.  If  the 
device  names  are  incorrect  in  any  of  these  programs,  the 
source  code  must  be  edited  to  the  proper  device  names. 

The  SCREENLIB.PA3  program  is  written  to  work  with  V  T 10  0 
terminals.  If  the  DBMON  using  computer  system  does  not  have 
VT100  terminal,  SCREENLIB.PAS  will  have  to  be  examined  with 
regard  to  the  escape  sequences.  for  example  the  VT100 
escape  sequence  is:  Esc [ Pn  ;Pn  f  .  Pn;Pnf  is  the  ASCII 
representation  of  the  rowjcolumn  of  the  cursor  position. 

The  following  Pascal  implementation  is  used  in 
SCREENLI B . PAS : 
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W  R  I  T  E  (  C1IR(  27)  ,  ’l’  ,  ROW  TENS  ,  ROW  ONES  ,  1  ,C0LTENS,C0L0NES,  ’  f  '  )  ; 

Where  C II  R(  2  7)  is  the  Esc  character,  and  ROWTENS,  COLTENS, 

ROW ONES,  and  COLONES  are  variable  name  representing  the 
cursor  position. 

The  next  installation  step  is  to  create  executable 
files  for  the  programs.  The  following  command  sequence  will 
perform  this  operation. 
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$eqp  demon 

$EQP  ANALDATA 

$  P  AS  SCREENLIB 

$  L  I  N  K  DBMON, SCREENLIB ,  - 

DU AO : [  INGRES . LIBRARY ] LIB Q/ LIBRARY  ,  - 

DU AO : (  INC  RES. LIBRARY) COM PATLIB/ LIBRARY 
$  LI  NK  ANALDATA, SCREENLIB,  - 

DUAO :[  I NG RES . LIBRARY ) LIBQ/ LIBRARY , - 
DUAO : l  I NC  RES . LI  BRARY ] COMP AT L IB/ LIBRARY 
$  P  AS  SETRUN 
$  L I NK  SETRUN 
$  P  AS  ME  RC  D  AT  A 
SLINK  MERC  DAT A 
SPAS  PRTREPORT 
SLINK  PRTREPORT 
SMACRO  INSTRUTIL 


The  last  installation  step  is  to  establish  the  1NGRE 
data  bases  used  by  the  DBMON  system.  Two  data  bases  are 
required;  one  for  the  report  library;  one  for  the 
statistical  and  graphical  analysis  files.  The  following 
commands  will  create  these  data  bases: 


GREAT EDB  DBMONLIB 
C  RE AT  E  D  B  DB MONDATA 


The  following  commands  will  prepare  the  report  library  fo 
use  by  DBMON. 


INGRES  DBMONLIB 

CREATE  LIBRARY  (  R E P 0 RT_ N AME = C4 0  , 

REPORT_DATE  =  C7 , FI LE_NUMB  ER= 12 ) / G 
CREATE  CURRENTFILE  ( F I LE_NUMB E R= 12 ) / G 
/  Q 


The  following  commands  will  prepare  the  statistical  and 
graphical  files  for  use  by  the  DBMON  system. 


$ 


INGRES  DBMONDATA 

CREATE  FILELIST  (  FILENAME=C9)/G 

CREATE  CPU  (  DBFUNC=C5 , VALUE =  FA ,  POS IT  10 N=  12 ) / G 
CREATE  BUFIO  ( DU FU NC= C5 , V ALU E= FA , P OS  I T I 0N=  1 2 ) / C 
CREATE  DIRIO  ( D B F U N C  = C 5 , V A L U E = F4 , P 0 S I T I  0 N =  1 2 ) / G 
CREATE  PAGEFLTS  (  DB  FU NC=  C5  ,  V  A L UE=  FA  ,  P  OS  I  T  I  0N=  1 2  )  /  C 
CREATE  WSS1ZE  ( DB F U NC= C5 , V ALU £= FA , P OS  I T I 0N=  1 2 ) / C 
CREATE  RESPTIME  ( D B FU N C= C 5 , V A LU E= FA , P OS  I T I  0 N=  1 2 ) / G 

/Q 


After  creating  the  INGRES  DBMONLIB  and  DBMONDATA  data 
bases,  the  following  INGRES  VMS  commands  should  be  executed 
in  order  to  improve  performance  of  the  data  bases. 


OPTIMIZEDB  DBMONLIB 
SYSMOD  DBMONLIB 
OPTIMIZEDB  DBMONDATA 
SYSMOD  DBMONDATA 

Periodic  use  of  these  optimization  commands  will  help  ensure 
that  the  INGRES  databases  used  by  DBMON  are  running  at  their 


highest  efficiency 
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SECTION  II 


OPERATIONAL  PROCEDURES 


Operational  Instructions 

The  DBMON  user  interlace  has  been  designed  around  the 
use  o  £  menus  and  data  entry  screens.  The  formats  are  not 
reproduced  entirely  in  this  manual,  but  enough  information 
is  given  in  order  to  clearly  describe  the  screen  format 
being  discussed. 

Main  Menu 

The  DBMON  user  works  directly  with  the  DBMON  and 
ANALDATA  programs.  The  DBMON  programs  contains  the  user 
interface  to  the  DBMON  system.  After  logging  into  the  DBMON 
directory,  the  '$RUN  DBMON'  command  will  initiate  the  DBMON 
User  Interface.  The  initial  screen  should  specify  that 
Version  3.0  is  running.  Pushing  the  return  key  will  bring 
the  user  to  the  main  menu: 

1..  5PECIFY  MEASURMENT  SESSION 

2. . DELETE  MEASUREMENT  SESSION 

3..  5HOW  STATUS  OF  MEASUREMENT  SESSION 

A.. ANALYZE  PERFORMANCE  DATA 

5 . .  HELP  FOR  THIS  MENU 

6  .  . EX  IT  P  ROG  RAM 

By  entering  the  number  of  the  desired  option  and  then 
depressing  the  return  key,  DBMON  will  proceed  to  the 
requested  function. 


Option  1  -  This  allows  a  measurement  session  to  be  specitied 

by  guiding  the  user  through  a  series  of  menus  and  data  entry 
prompts.  This  series  is  discussed  in  the  SPECIFY 
MEASUREMENT  SESSION  section  below. 

Option  2  -  This  will  allow  the  user  to  delete  a  measurement 

session  that  is  currently  executing  or  awaiting  execution. 
Option  3  -  This  option  allows  the  user  to  inspect  the 

current  status  of  the  performance  monitor  (i.e.  complete, 
waiting,  etc.). 

Option  4  -  This  option  allows  collected  performance 
measurements  to  be  displayed  as  a  report,  displayed 
graphically,  or  statistically  analyzed.  This  section  also 
provides  access  to  the  report  library.  Further  detail  is 
provided  in  the  Analyzing  Measurement  Data  section  below. 
Option  5  -  This  option  presents  help  information  about  the 

main  menu. 

Option  6  -  This  terminates  execution  of  the  user  interface. 
If  a  measurement  session  was  specified  it  will  prompt  the 
user  with  the  following  instructions: 

TO  BEGIN  MONITOR  EXECUTION 

ENTER  THE  FOLLOWING  VAX/ VMS  COMMAND 

$  SUBMIT/ NOLOG  FILE  [ D B MO N ]  D B MO N 1 N  I  T 

This  command  will  submit  the  performance  monitor  into  the 
batch  job  queue.  The  monitor  will  run  according  to  the 
specifications  the  user  provided.  If  a  monitor  session  was 


not  established,  the  following  informative  message  is 
displayed  : 

NO  MONITOR  SESSION  ESTABLISHED 

If  at  any  time  during  the  execution  of  the  user  interface  an 
incorrect  instruction  is  entered,  the  message  -  SELECTION 
INVALID  --  PLEASE  TRY  AGAIN  -  will  be  displayed.  For  any 
reason  the  user  interface  may  be  aborted  by  using  the  CTRL  C 
sequence  with  no  ill  effects. 

Specifying  a  Measurement  Session 

Specifying  a  measurement  session  involves  the 
successful  completion  .of  the  following  steps: 

(1)  Selecting  a  performance  parameter  set. 

(2)  Specifying  performance  tool  parameters. 

(3)  Selecting  data  analysis  option. 

(4)  Selecting  data  presentation  option. 

(5)  Verifying  selected  options  and  entered  data. 

The  following  paragraphs  describe  the  steps  listed  above  in 
greater  detail. 

Selecting  a  performance  parameter  set.  This  is  done  by 


selecting  from  the  Parameters  Menu: 


,iw 


1..  MEASURE  ALL  PARAMETERS 

2.  .MEASURE  SOFTWARE  ENGINEER'S  SUBSET 

3.  .MEASURE  DBA'S  SUBSET  (DETAILED  VIEW) 

4..  MEASURE  SYSTEM  MANAGER'S  SUBSET 

5. . MEASURE  DBA'S  SUBSET  (HIGH  LEVEL  VIEW) 

6.  .MEASURE  DBMS  DESIGNER'S  SUBSET 

7.  .SELECT  A  SPECIALIZED  SUBSET 
8  .  .HELP  FOR  THIS  MENU 

9..  RETURN  TO  MAIN  MENU 


Option  1  -  selects  all  possible  parameters  for  measurement. 

Option  2  through  6  -  selects  predefined  parameter  sets. 
Option  7  -  allows  a  special  subset  to  be  defined. 

Option  8  -  displays  help  information  for  Parameters  menu. 
Option  9  -  cancels  the  request  for  a  measurement  session  and 
returns  the  user  to  the  main  menu. 

Enter  Data  Specifying  Performance  Tool  Parameters  . 

This  data  is  used  to  specify  session  control  information. 
This  is  done  with  six  data  entry  prompts.  Each  explains  its 
purpose,  the  required  format,  provides  a  sample  entry,  and 
has  a  default  value.  The  prompts  include,  session  name, 
session  start  date,  stop  date,  start  time,  stop  time,  and 
data  collection  interval. 

Select  a  Data  Analysis  Option.  The  following  Data 
Analysis  Menu  is  used: 


1  .  .STANDARD  ANALY  S I S 

2  .  .  RETURN  TO  MAIN  MENU 


Option  1  -  selects  the  data  analysis  performed  by  the  VAX 

utilities.  This  has  been  predefined,  so  this  menu  exists  to 
provide  for  any  future  expansion  of  the  monitor. 


Option  2  -  cancels  the  request  for  a  measurement  session  and 

returns  t  h  e  user  to  the  main  menu. 

Select  a  Data  Presentation  Option .  The  Data 
Presentation  Menu  is  used  to  select  this  option: 

1..  PRINT  MEASUREMENT  REPORT 

2..  RETURN  TO  MAIN  MENU 

Option  1  -  produces  the  measurement  report  that  can  be  then 

printed  on  the  system  printer. 

Option  2  -  cancels  the  request  for  a  measurement  session  and 

returns  the  user  to  the  main  menu. 

Verify  the  Selected  Menu  Options  and  Entered  Data  . 

This  section  displays  the  just  entered  session  information 
and  prompts  the  user  with: 

DO  YOU  WISH  TO  CHANGE  ANY  INFORMATION  (Y/N)  > 

If  the  response  is  N,  the  command  procedure  and  session  log 
files  are  created,  and  the  user  is  returned  to  the  main 
menu.  If  the  reponse  is  Y,  the  following  Change  Information 
Menu  is  displayed: 

1..  CHANGE  MEASUREMENT  SESSION  NAME 

2 . . CHANGE  START  DATE 

3 . . CHANGE  START  TIME 

4 . . CHANGE  STOP  DATE 

5. . CHANGE  STOP  TIME 

6. . CHANGE  DATA  COLLECTION  INTERVAL 

7. . REDISPLAY  SESSION  INFORMATION 
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Options  l  through  6  -  allow  that  item  to  be  reentered  using 
the  same  procedures  as  it  was  originally  entered  with. 
Option  7  -  returns  to  the  Measurement  Information  Screen 
where  more  changes  may  be  selected  or  control  may  be 
directed  back  to  the  main  menu. 

Analyzing  Measurement  Data 

Option  4  of  the  Main  Menu  brings  up  the  Performance 
Data  Analysis  Menu: 

1 . . VIEW  MEASUREMENT  DATA 

2..  VIEW  INSTRUMENT  DATA 

3. . PERFORM  REPORT  LIBRARY  OPERATIONS 

4 . .  HELP  FOR  THIS  MENU 

5..  RETURN  TO  MAIN  MENU 

t 

Option  l  -  allows  the  system  performance  parameter  data 
collected  during  a  measurement  session  to  be  examined. 
Option  2  -  allows  the  data  collected  by  the  instrumentation 

utility  to  be  examined  directly,  and  graphically  presented. 
Option  3  -  allows  the  storage,  retrieval,  or  deletion  of 

performance  report  files  into/ from  the  performance  report 
library . 

Option  4  -  displays  help  information  for  this  menu. 

Option  5  -  returns  the  user  to  the  main  menu. 

These  options  are  discussed  in  greater  detail  in  the 
following  sections. 
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View  in;;  Me  a  s  u  r  e  me  n  t  Data 

This  section  allows  the  examination  of  the  measurement 
report  produced  by  the  last  measurement  session.  Upon 
selecting  option  1  of  the  Performance  Data  Analysis  Menu, 
the  following  menu  is  presented: 


€* 


1 .. VIEW  SESSION  INFORMATION 

2. . VIEW  EFFECTIVENESS  DATA 

3. . VIEW  EFFICIENCY  DATA 
b . . HELP  FOR  THIS  MENU 

5..  RETURN  TO  DATA  ANALYSIS  MENU 

Option  1  will  display  the  measurement  session  specifications 
that  were  used  in  the  preparation  of  the  current  measurement 
report  . 

Option  2  will  display  a  menu  that  allows  the  user  to  view 
productivity,  response,  integrity,  and  security  data  from 
the  measurement  report. 

Option  3  will  display  a  menu  that  allows  the  user  to  view 
allocation,  utilization,  memory,  10,  channel,  device 
utilization,  queueing,  or  deallocation  data  from  the 
measurement  report. 

Option  4  will  display  menu  help  information. 

Option  3  returns  control  to  the  Data  Analysis  Menu. 


V i e  w i ng  Instrument  Data 

This  area  allows  the  user  to  examine  measurement  data 
collected  by  the  instrumentation  utility.  It  provides 


direct  examination,  graphical  representation,  and 


statistical  analysis. 

Upon  selecting  option  2  of  the  Performance  Data 
Analysis  Menu,  the  following  Instrument  Analysis  Menu  is 
displayed: 

1.. VIEW  INSTRUMENT  INFORMATION 

2.  .VIEW  INSTRUMENT  UTILITY  DATA 

3.  .DISPLAY  INSTRUMENT  DATA  GRAPHICS 

4.  .PERFORM  STATISTICAL  OPERATIONS 
5  .  . HELP  FOR  THIS  MENU 

6..  RETURN  TO  DATA  ANALYSIS  MENU 

Option  1  selection  will  cause  the  display  of  instrument 
session  information  listing  the  data  bases  that  were 
accessed,  and  the  name  of  the  DBMS  application  program. 
Option  2  will  display  a  menu  that  will  allow  the  display  of 
DML  response,  utilization,  10,  and  memory  data  from  the 
instrumentation  utility  report. 

Option  3  will  allow  the  graphical  representation  of 
instrument  data.  Paragraph  Instrument  Data  Graphics 
dicusses  the  details  below. 

Option  4  allows  for  the  statistical  analysis  of  instrument 
data.  Paragraph  Instrument  Statistics  further  discusses 
this  option. 

Option  5  displays  menu  help  information  for  the  Instrument 
Analysis  Menu. 

Option  6  returns  program  control  to  the  Data  Analysis  Menu. 

Instrument  Data  Graphics.  Selection  of  Option  3  of  the 
Instrument  Analysis  Menu  will  present  the  following  menu: 
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L  .  .DHL  RESPONSE  TIMES 

2.. DML  CPU  USAGE 

3.. UML  SUFFERED  10 
4  .  .DHL  DIRECT  10 

5..  DHL  PACE  FAULTS 
6  .  .  DML  WORKING  SET 

7..  RETURN  TO  INSTRUMENT  ANALYSIS  MENU 


Options  1  through  6  will  present  a  bar  graph  displaying  the 
frequency  of  the  requested  measures  broken  into  eight 
equally  sized  groups. 


Option  7  will  return  control  to  the  Instrument  Analysis 


Menu  . 


The  data  elements  that  make  up  the  eight  bars  on  the 
graph  may  be  examined  with  an  interactive  INGRES  command. 
From  left  to  right  the  eight  bars  are  numbered  1  through  8. 
The  following  INGRES  data  base  file  names  correspond  to  the 
six  DML  parameters: 


PARAMETER 

DML  RESPONSE  TIMES 
DML  CPU  USAGE 
DML  BUFFERED  10 
DML  DIRECT  10 
DML  PAGE  FAULTS 
DML  WORKING  SET 


INGRES  FILE  NAME 
RESPTIME 
CPU 
BUFIO 
D  I  RI  0 
PG  FLTS 
WS  l  ZE 


The  following  command  is  an  example  of  the  command  required 
to  examine  what  DML  is  in  a  particular  bar  on  the  graph. 
This  command  will  list  the  DML  instructions  that  had  the 


highest  response  times: 


RANGE  OF  R  IS  RESPTIME 

PRINT  RESPTIME  WHERE  R.P0SITI0H=8 


Instrument  Statistics  .  This  option  will  allow  two 
statistical  data  files  to  be  compared  with  the  Hi lcoxon 
Rank-Sum  Test.  Upon  selection  of  option  4  of  the  Instrument 
Analysis  Menu,  the  user  will  be  presented  with  the 
Instrument  Statistics  Menu: 


1..  ENTER  STATISTICAL  FILE  NAMES 

2. . 5.LECT  ALPHA  LEVEL  (DEFAULT  IS  .01) 

3..  5.LECT  STATISTICAL  PARAMETER  AND  PERFORM  TEST 

4. . DELETE  STATISTICAL  FILE 

3 . .  HELP  FOR  THIS  MENU 

6..  RETURN  TO  INSTRUMENT  ANALYSIS  MENU 


Option  1  will  prompt  the  user  for  the  names  of  the  two 
statistical  files  that  are  to  be  compared.  Theses  file 
names  must  be  the  same  as  those  specified  during  their 
creation  by  the  ANALDATA  Program. 

Option  2  presents  the  following  menu: 


1 . . ALPHA  =  .01 

2 . .  ALPHA  =  .05 


where  options  1  and  2  allow  the  user  to  specify  what  alpha 
level  the  statistical  test  is  to  assume. 

Option  3  presents  the  foilwing  menu: 


1  .  . D  M L  RESPONSE  TIMES 

2 . .  DML  CPU  USAGE 
3.  .DM1.  SUFFERED  10 
4  .  . D  M  L  DIRECT  10 

5 . .  DML  PAGE  FAULTS 

6..  DML  WORKING  SET 
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7.. RETURN  TO  INSTRUMENT  ANALYSIS  MENU 


where  options  1  through  6  will  perforin  the  statistical 


comparison  of  the  selected  parameter  using  the  two  files 
previously  specified  with  the  specified  alpha  level,  and 
indicate  to  the  user  if  there  is  a  statistical  difference 


between  the  two  files  with  regard  to  the  selected  files. 
Option  7  returns  control  to  the  Instrument  Analysis  Menu. 
Option  A  allows  the  user  to  delete  previously  created 


statistical  analysis  files. 

Option  5  provides  menu  help  for  the  Instrument  Statistics 


Option  6  returns  the  user  to  the  previous  menu. 


P erforming  Report  Library  Operations 


This  section  allows  the  user  to  store  measurement 
reports  into  a  library,  retrieve  them  when  needed,  and 
delete  the  reports  that  are  no  longer  required.  Upon 


selecting  option  3  of  the  Performance  Data  Analysis  Menu, 
the  following  Menu  is  displayed: 


1  ..LIST  LIBRARY  ENTRIES 

2..  5.ORE  REPORT  IN  LIBRARY 

3..  RETRIEVE  REPORT  FROM  LIBRARY 
A.. DELETE  REPORT  FROM  LIBRARY 

3  .  .HELP  FOR  THIS  MENU 

6..  RETURN  TO  ANALYSIS  MENU 


AVV- 


.y.-.y. 


Option  1  displays  the  contents  of  the  INGRES  table  that 
maintains  the  report  library  index.  This  allows  the  user  to 
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determine  what  reports  are  stored  in  the  report  library. 
Option  2  will  allow  the  user  to  store  a  performance  report 
in  the  library.  The  user  is  prompted  for  the  title  of  the 
report  to  be  stored,  the  date  of  the  report,  and  the  VMS 
filename  where  the  report  is  currently  residing. 

Option  3  will  prompt  the  user  for  the  title  and  date  of  a 
report  in  the  library,  and  also  a  legal  VMS  filename  which 
is  to  contain  the  report  obtained  from  the  library. 

Option  4  will  delete  a  report  in  the  library  after  prompting 
for  the  report  title  and  date. 

Option  5  displays  menu  help  information  for  the  Report 
Library  Menu. 

Option  6  returns  control  to  the  Analysis  Menu. 


The  title  and  date  of  the  report  must  be  unique  for  each 
report.  They  are  the  identification  that  the  library  uses 
to  keep  track  of  the  reports.  The  title  may  be  up  to  40 
characters  in  length,  and  is  intended  to  be  descriptive  of 
the  contents  of  the  reports.  The  reports  that  are  intended 
for  storage  are  INSTRUT1L.DAT,  the  instrumentation  report, 
and  DATAF1LE.DAT,  the  raw  instrumentation  data,  and 
FKINTLR.DAT,  the  measurement  report.  When  retrieving  these 
reports,  they  should  be  placed  into  the  appropriate  VMS 
filename  so  that  the  User  Interface  will  be  able  to  display 
the  retrieved  reports.  The  contents  of  the  report  library 
may  be  viewed  by  executing  the  toll  owing  interactive  INGRES 

.v.v.v 


command 


PR1NTR  DEMON LIB  LIBRARY 

Analdata  Operational  Instructions 

Upon  completion  of  tlie  performance  measurement  session, 
the  following  VMS  command  must  be  executed  in  order  to 
consolidate  the  raw  instrument  data  files  into  one  file: 

$  C  OP  Y  INSTR.DAT;*  DATA  FILE. DAT 

Mow  the  Data  Analysis  program  must  be  executed.  This  is 
accomplished  by  first  entering  the  following  VMS  command: 

$  RUN  ANALDATA 

This  program  will  first  display  the  following  menu: 

1..  ANALYZE  TOTAL  DATA 

2. . ANALYZE  INGRES  DATA 

3..  EXIT  PROGRAM  (HO  ANALYSIS) 

Option  1  specifies  that  the  data  to  be  analyzed  is  TOTAL 
DBMS  measure  went  data. 

Option  2  specifics  that  the  data  to  be  analyzed  is  INGRES 
DBMS  measurement  data. 

Option  3  stops  execution  of  the  Data  Analysis  Program. 
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If  either  option  1  or  2  is  selected,  the  user  is  then 
prompted  for  a  yes  or  no  response  to  determine  if  a 


.V. 


statistical  analysis  file  is  to  be  created.  If  yes,  then 


the  user 

i  s 

prompted  for  an 

up  to 

nine  character 

filename 

t  h  a  t 

will 

identify  the  stat 

i  s  t  i  c  a  1 

analysis  file 

.  If  no , 

a  n  a  1  y 

sis 

o  f 

instrumental  ion 

data  continues  without  the 

c  r  e  a  t 

ion 

of 

a  statistical  analysis 

file.  Dur  i  ng 

the 

a  n  a  1  y 

sis, 

this  informative 

me  s  s  age 

is  displayed: 

ANALYSIS  IN  PROGRESS 


If  a  statistical  file  was  to  have  been  created,  then  upon 
program  termination,  the  user  specified  filename  is 
confirmed  with  an  informative  message  to  the  user. 

ANALDATA  also  automatically  produces  the  graphical 
analysis  files.  The  last  execution  of  ANALDATA  will  be 
reflected  in  the  graphical  data  that  can  be  viewed  in  the 
D  B  M  0  N  Program. 

After  execution  of  the  ANALDATA  program,  the  following 
VMS  instruction  must  be  entered: 


(d  SORT  I  NSTR.COM 


This  instruction  will  produce  the  S0RT0UT.DAT  file  which  the 
D 11  MON  interface  program  uses  to  display  the  Instrument 
Report  . 
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Use  of  the  Instrumentation  Facility 

The  Instrumentation  Utility  is  a  set  of  external 
procedures  written  in  in  VAX  MACRO-11  Assembly  Language. 
Calls  to  these  subroutines  are  embedded  into  DBMS 
application  programs  before  and  after  each  DBMS  command  that 
is  to  have  its  performance  recorded. 

Any  application  program  that  is  to  be  measured  by  the 
DBMON  system  will  have  to  be  modified  to  include  the  (1) 
declaration  of  three  external  procedures,  (2)  placement  of 
calls  to  these  procedures,  and  (3)  recompilation  of  the 
application  program.  The  required  calls  are  described  in 
the  following  sections. 

1.  Initutility  -  This  procedure  initializes  the 
instrumentation  utility  and  creates  a  data  file  for  the 
recording  of  performance  parameter  values.  This  procedure 
is  typically  called  once  before  the  TOTAL  sign  on  command, 
or  just  after  the  initial  INGRES  command.  If  this  procedure 
is  called  again,  it  will  cause  the  creation  of  a  separate 
data  collection  file  (1NSTR.DAT).  This  provides  the 
capability  to  tailor  the  contents  of  data  files  for  use  in 
specific  performance  tests.  The  format  of  this  command  is: 

1 N1TUT1L1TY(  DBMSNAME, P ROGRAHNAHE , DB NAME , STATU S ) 

where  DBMSNAME  is  either  'TOTAL  '  or  'INGRES',  PROCRAMNAME 
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is  the  name  of  the  application  program,  DBNAME  is  the  name 
of  the  data  base,  and  STATUS  is  the  completion  status  of  the 
INI T UTILITY  procedure.  The  first  three  parameters  are 
Pascal  string  input  parameters  to  the  procedure.  They  may  be 
either  declared  varaibles  or  literals.  STATUS  is  an  output 
parameter  and  must  be  a  declared  variable. 

2.  MLASUREDBMS  -  This  procedure  records  the  state  of 
the  DBMS  just  prior  to  the  execution  of  a  DML  command  or 
group  of  commands.  This  procedure  call  is  placed  just 
before  the  TOTAL  DATBAS  call  or  any  of  the  embedded  INGRES 
EQUEL  commands.  The  format  of  this  command  is: 

MEASUREDBMS(  DBMSFU NOTION, DB M S F 1 L E N AME , STATUS) 

where  DBMSFUNCT10N  is  the  name  of  the  DML  command, 

DBMS  FILENAME  is  the  name  of  the  database  file,  and  STATUS  is 
the  completion  status.  The  input  parameter  may  be  string 
varaibles  or  literals.  STATUS  must  be  a  declared  string 
variable. 

3.  ENDMEASURE  -  This  procedure  records  the  state  of 
the  DBMS  just  after  a  DML  command.  This  call  should  be 
placed  just  after  a  TOTAL  DATBAS  call  or  an  INGRES  EQUEL 
command.  The  format  of  this  command  is: 

ENDMEASURE(ENOCODE, STATUS) 
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where  ENDCODE  is  an  input  parameter  and  STATUS  is  an  output 
parameter.  ENCODE  may  be  a  literal  or  declared  variable. 
STATUS  must  be  a  declared  string  variable.  ENDCODE  may  have 
one  of  two  values:  'ENDDML'  or  'ENDFRG'.  ENDPRG  is  used 
when  the  last  measurement  has  been  made  and  denotes  the  end 
of  the  mesurement  session.  Another  call  to  1N1TUTILITY 
would  be  required  to  use  the  Instrumentation  Utility. 

ENDDML  is  used  at  all  other  times  to  denote  the  end  of  a  DML 
command . 

Status  Codes .  There  are  two  possible  status  codes 
that  are  returned  by  the  Instrumentation  Utility  calls.  A 
successful  completion  code  is  denoted  by  the  value  '****'. 

An  error  condition  is  indicated  by  the  value  'EROR'.  An 
error  condition  will  also  disable  the  Instrumentation 
Utility,  so  a  call  to  INITUTIL1TY  will  be  required  to 
reinitialize  the  utility.. 

Preparation  of  the  Application  Program  .  After  the 
I nstu mentation  Utility  calls  are  embedded  into  the 
application  program,  the  program  must  be  recompiled.  At 
t h i s  point  the  following  LINK  command  must  be  used  when  a 
TOTAL  application  is  being  instrumented: 

?  L  1  N K  <program-name> , <dev> : [ DEMON]  INST R UTIL,  - 
<  d  e  v  >  :  [ TOTAL) NATUATBAS, N  A  T  B  U  E 


When  an  INGRES  application  is  being  instrumented  the 
following  command  is  to  be  used: 


W4.TT.VWwV.  WWWT-' 


LINK  <prograin-name>  ,  <dev>  :[  I  NGRES  .  LIBRARY]  LIBQ/ LIB  RARY  ,  - 

<dev>  :[  INGRES .LIBRARY] COMP ATL1B/ LI B RARY 


Instumcntat ion  Utility  Execution.  When  the 


instrumented  application  program  is  run,  it  will  record  data 
in  the  INSTR.DAT  file.  The  Instrumentation  Utility  may  be 
used  in  a  stand  alone  manner  without  using  the  DBMON 
interface  generated  measurement  session.  All  of  the 
INSTR.DAT  files  created  during  stand  alone  operation  must  be 
merged  by  the  following  command: 


COPY  INSTR.DAT;*  DATAFILE . DAT 


When  a  measurement  session  is  conducted  through  the  DBMON 
interface,  this  merging  of  data  files  will  occur 
automatically. 

Instrumentation  Utility  Example.  The  following  is  an 
example  of  the  embedded  Instrumentation  Utility  calls. 


PROGRAM  EXAMPLE!  INPUT, OUTPUT)  ; 

TYPE  BUFF4  =  PACKED  ARRAY  J1..4J  OF  CHAR; 

BUFF5  =  PACKED  ARRAY  [I  .  . 5  I  OF  CHAR; 

BUFF6  =  PACKED  ARRAY  (1..6J  OF  CHAR; 

BUFFI  5  =  PACKED  ARRAY  [1..15]  OF  CHAR; 


*.*  I 

•  .*  / 
* 


PROCEDURE  INI ’FUTILITY!  %STDESCR  DBMSNAME  :  BUFF6  ; 

%STDESCR  PROGRAMNAME :BUFF1  5 ; 
^STDESCR  DATABASENAMEIBUFF6 ; 

%  STDESCR  STATUS : BUFF4) ;  EXTERN; 


i\*>  v'V 


PROCEDURE  MF.ASUKEDBMS! % STDESCR  D B M S F U N C T I  0 N : B U F F 5 ; 

% STDESCR  DBMSFI LENAME : BUFF4 ; 
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%STDESCK  STATUS :BUFF4) ;  EXTERN; 

PROCEDURE  ENDMEASURE(  %  STDESCR  E ND C OD E : B U FF4  ; 

%STDESCR  STATUS : BUFF4 )  ;  EXTERN; 

PROCEDURE  GETDATA; 

PROCEDURE  DATB AS ( CALL  PARAMETERS...); 

BEGIN 

MEASUREDBMS( COMMAND, FNAME,  STATUS)  ; 

DATB AS ( COMMAND,  .  .  .  , FNAME,  .  .  .)  ; 

ENDMEASURE(  ' ENDDML  1  .STATUS)  ; 

END  ; 

BEGIN  (*  MAIM  PROGRAM  *) 


1N1TUTILITY(  'TOTAL  '  ,  'EXAMPLE 
' DEMODB ’ , STATUS) ; 

GETDATA ; 

ENDMEAS  U  RE(  ' ENDPRG '  .STATUS)  ; 
END  . 


Legal  DBMS  Functions.  The  DBMSFUNCTION  parameters  used 
in  the  MeasureDBMS  procedure  are  the  DML  commands  used  in 
TOTAL  and  INGRES.  All  TOTAL  DML  commands  are  five  charaters 
in  length,  so  TOTAL  commands  are  specified  in  MeasureDBMS 
just  as  they  are  used  in  DATBAS  calls.  INGRES  DML  commands 
are  of  variable  lengths,  so  the  following  five  character 
abbreviations  must  be  used  with  INGRES  applications  of  the 
Instrumentation  Utility. 


INGRES  EQULL  COMMAND  DBMON  ABBREVIATION 


ABORT 

ABORT 

APPEND 

APEND 

BEGIN  TRANSACTION 

BEGTR 

COPY 

COPY 

CREATE 

CREAT 

DEFINE 

DEFIN 

DELETE 

DELET 

DESTROY 

DESTR 

END  TRANSACTION 

ENDTR 

HELP 

HELP 

INDEX 

INDEX 

INTEGRITY 

INTEG 

PERMIT 

PERMI 

RANGE 

RANGE 

REPLACE 

REPLA 

RETRIEVE 

RETRV 

SAVE 

SAVE 

SAVEP 

SAVEP 

SET 

SET 

VIEW 

VIEW 

DBMON  Outputs 


Execution  of  the  DBMON  system  produces  various  files 


and  reports.  Raw  data  files  are  listed  below. 


DBMS  JOB . DAT 
1 NSTR . DAT 
1 N ST KM NT . DAT 
L0GFA1L.DAT 
LOG  S  RC . DAT 
MONITOK.DAT 


PERFORM . DAT 
SORTODT . DAT 
SYSERR.DAT 
SY  STEM . DAT 
TOTAL . DAT 


These  files  are  analyzed'and  summarized  to  produce  the 
following  report  files: 


1NSTRUT1L.DAT  -  the  instrumentation  report 
PR1NTER.DAT  -  the  measurement  report 

Either  of  these  reports  may  be  printed  on  the  system 
printers,  or  viewed  by  executing  the  DBMON  interface 


program 
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SECTION  III  -  DB MON  User's  Methodology 

DP MON  User's  Methodology 

Methodology  can  be  defined  as  the  synthesis  of  methods 
and  tools.  The  Tool  in  this  case  is  the  DBMON  system. 

DBMON  and  the  methods  of  its  application  comprise  a  DBMON 
User's  Methodolgy  as  shown  in  Figure  E-2.  This  methodology 
consists  of  the  folio  wing  five  phases: 

1.  Understand  the  System  -  This  phase  involves 
familiarization  with  the  VAX  11/780  computer  system,  the 
TOTAL  and  INGRES  DBMSs,  and  the  DBMS  application  being 
studied. 

2.  Identify  Problem  Areas  -  This  phase  involves  analyzing 
the  use  of  a  DBMS  to  identify  any  potential  problem  areas 
that  need  to  be  addressed.  This  phase  could  also  involve 
making  and  storing  benchmark  measurements  against  which  to 
guage  any  future  performance  degredations. 

3.  Formulate  a  Performance  Improvement  Hypothesis  -  Once 
familiar  with  the  system,  and  having  identified  a  problem 
area,  possible  performance  improvement  hypothsis  can  be 
listed.  These  hypothesis  should  be  analyzed  to  see  if 
they  are  feasible.  Unrealistic  solutions  to  performance 
problems  should  be  rejected  at  this  stage. 

A.  Test  Performance  Improvements  -  This  stage  involves 
the  design,  implementation,  and  analysis  of  an  experiment. 
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Tlie  hypothesis  from  phase  four  can  be  implemented  and 
statistically  evaluated  against  the  benchmark  testing  from 
phase  two. 

5.  Implement  Performance  Improvement  Modifications  -  The 
statistical  evaluation  of  phase  four  should  indicate  the 
most  effective  modifications  that  can  be  made.  In  this 
phase,  the  modifications  should  be  installed  and  validated 
for  effectiveness  and  efficiency. 


This  methodology  uses  the  DBKON  system  in  phases  two 
and  four.  In  phase  two  DBM ON  can  be  used  to  record 
benchmark  mesurement  data.  This  can  be  done  to  identify 
possible  problem  areas,  or  to  maintain  a  historical  record 
of  DBMS  performance. against  which  to  guage  future  DBMS 
performance.  This  can  allow  the  identification  of  long  term 
performance  changes. 

In  phase  four  the  DEMON  system  is  used  to  record 
measurement  data  after  a  change  to  the  DBMS  application  or 
its  environment  is  made.  A  statistical  comparison  between 
the  new  measurements  and  the  benchmark  made  during  phase  two 
will  allow  the  DBMS  analyst  to  determine  if  the  improvements 
made  are  of  any  performance  value. 
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Experimental  Procedure 

With  the  identification 
problem,  an  experiment  may 
solution  is  possible.  The 


of  a  possible  DBMS  performance 
be  conducted  to  determine  if  a 
following  steps  need  to  be  taken: 


(1)  Instrument  the  application  program. 

(2)  Set  up  and  execute  a  monitor  session  while  running  the 
application  program. 


(3)  Analyze  the  resulting  data,  and  create  a  statistical 
analysis  file. 


(A)  By  examining  the  analyzed  performance  data,  formulate 
a  performance  improvement  hypothesis. 

(3)  Implement  the  performance  improvement. 

(6)  Set  up  and  execute  a  monitor  session  while  running  the 
application  program  with  the  improvement  modifications 
made  . 


(7)  Analyze  the  newly  collected  performance  data,  and 
produce  a  statistical  analysis  file. 


(8)  Compare  the  two  statistical  analysis  files  to 


determine  if  the  performance  improvement  modifications  are 
statistically  significant. 

Following  this  application  of  the  DBMON  User's  Methodology 
can  result  in  a  solution  to  a  performance  problem  if  one 
exists.  The  DBMON  system  is  only  a  tool  towards  this  end, 
the  key  factor  in  this  process  is  the  ability  to  identify 
the  cause  of  the  DBMS  performance  problem  and  to  find  a 


solution. 


TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2  -  Perforin  the  necessary  statistical  and/or 

graphical  analysis. 


TEST  CASES: 

1.  No  analysis  requested. 

2.  One  specific  analysis  requested. 

3.  All  possible  analysis  requested. 


EXPECTED  RESPONSE: 

1.  No  analysis  performed. 

2.  Requested  analysis  performed. 

3.  All  possible  analysis  performed. 


RESULTS : 


CASE 

1  . 

-  PASS: 

X 

FAIL  : 

DATE : 20 

AUG 

85 

CASE 

2  . 

-  PASS; 

X 

FAIL: 

DATE :20 

AUG 

85 

CASE 

3  . 

-  PASS: 

X 

FAIL: 

DATE: 20 

AUG 

85 

REMARKS:  No  problems  encountered 
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TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2.1  -  Allow  the  user  to  specify 

tests  to  be  performed  on  the  measurement  data. 


statistical 


TEST  CASES: 


1.  Ho  test  is  requested. 

2.  One  specific  test  is  requested. 

3.  All  possible  tests  are  requested 


EXPECTED  RESPONSE: 


1.  No  analysis  is  scheduled. 

2.  Requested  analysis  is  scheduled. 

3.  All  possible  analysis  is  scheduled 


RESULTS 


REMARKS:  No  problems  encountered. 


s. 
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CASE 

1  . 

-  PASS: 

X 

FAIL: 

DATE  :  20 

AUG 

85 

■s 

CASE 

2  . 

-  PASS: 

X 

FAIL: 

DATE  :  20 

AUG 

85 

CASE 

3  . 

-  PASS:- 

X 

FAIL: 

D AT E  :  2 0 

AUG 

85 
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TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2.2  -  Allow  the  user  to  specify  graphics 
representations  to  be  made  of  the  measurement  data. 


TEST  CASES: 

1.  No  graphical  representation  is  requested. 

2.  One  graphical  representation  is  requested. 

3.  All  possible  graphics  are  requested. 


EXPECTED  RESPONSE: 

1.  No  graphics  are  scheduled. 

2.  Requested  graphics  is  scheduled. 

3.  All  possible  graphics  are  scheduled. 


RESULTS : 


CASE 

1  . 

-  TASS: 

X 

FAIL: 

DATE  :  2  5 

AUG 

85 

CASE 

2  . 

-  PASS: 

X 

FAIL: 

DATE :  2  5 

AUG 

85 

CASE 

3  . 

-  PASS: 

X 

FAIL: 

DATE : 25 

AUG 

85 

REMARKS:  No  problems  encountered 


yNuw»^.>'k.,vvv'.^ 


•>  '  V. •v.’TT 


TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  3.2.3  ~  Create  output  files  of  statistical  and 
graphical  analysis  data. 


TEST  CASES: 

1.  No  statistical/graphical  analysis  is  requested. 

2.  Some  s t a t  i  s t i c a  1  / g r a p h  i  c a  1  analysis  is  requested 


EXPECTED  RESPONSE: 

1.  No  output  files  are  created. 

2.  A  s t a t i s t i c a  1 / g r a p h  i  c a  1  output  file  is  created 


RESULTS : 


CASE  1.  -  PASS:  X  FAIL: 
CASE  2.  -  PASS:  X  FAIL: 


DATE : I  5  AUG  85 
DAT E : 1 5  AUG  85 


REMARKS:  No  problems  encountered. 
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TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  4.4  -  Display  graphical  presentations  of 
specified  performance  measurement  data. 


TEST  CASES: 

1.  No  graphical  representation  was  requested. 

2.  One  graphical  representation  was  requested 

3.  All  possible  graphics  were  requested. 


EXPECTED  RESPONSE: 

1.  No  graphics  are  displayed. 

2.  One  graphical  representation  is  availble  for  display, 

3.  All  possible  graphics  are  availible  for  display. 


RESULTS : 


CASE  1. 
CASE  2. 
CASE  3. 


PASS: _ X_  FAIL: 

PASS: _ X_  FAIL: 

PASS:  X  FAIL: 


DATE : 2 5  AUG  85 
DATE : 25  AUG  83 
DATE : 2 5  AUG  85 


REMARKS:  No  problems  encountered. 


l-— •  - 1. » ft. .*•  .  A .  .v.  •  -  ■  -  •  •  ■  •  -s .  • 


TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 


REQUIREMENT:  4.5  -  Allow  the  user  to  maintain  historical 
performance  measurement  data. 


TEST  CASES: 

1.  No  library  maintenance  requested. 

2.  Library  maintenance  activity  is  requested. 

EXPECTED  RESPONSE: 

1.  No  library  activity  is  undertaken. 

2.  Requested  library  function  is  performed. 

RESULTS : 

CASE  1.  -  PASS: X_  FAIL: _  DATE :  10  AUG  85 

CASE  2.  -  PASS:  X  FAIL: _  DAT  E : 1 0  AUG  85 

REMARKS:  No  problems  encountered. 
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REQUIREMENT:  4.5-1  -  Allow  the  user  to  store  performance 
reports  in  a  library. 


TEST  CASES: 

1.  No  storage  of  reports  is  requested. 

2.  Library  storage  is  requested. 


EXPECTED  RESPONSE: 

1.  No  report  storage  occurs. 

2.  A  performance  report  is  stored  in  the  library. 

RESULTS : 

CASE  1.  -  PASS: X_  FAIL: _  DATE:  10  AUG  85 

CASE  2.  -  PASS:  X  FAIL:  DATE: 10  AUG  85 


REMARKS:  No  problems  encountered 


TEST  PLAN  RESULTS  FOR  FOR  A  DBMS  PERFORMANCE  MONITOR 

REQUIREMENT:  4.5*2  -  Allow  the  user  to  retrieve  performance 
reports  from  a  library. 

TEST  CASES: 

1.  No  retrieval  of  reports  is  requested. 

2.  Library  retrieval  is  requested. 

EXPECTED  RESPONSE: 

1.  No  report  retrieval  occurs. 

2.  A  performance  report  is  retrieved  from  the  library. 

RESULTS : 

CASE  1.  -  PASS:  X  FAIL: _  DAT  E  :  1 0  AUG  85 

CASE  2.  -  PASS: X_  FAIL: _  DATE  :  10  AUG  85 

REMARKS:  No  problems  encountered. 
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REQUIREMENT:  4.5.3  -  Allow  the  user  to  delete  performance 
reports  from  a  library. 


TEST  CASES: 

1.  No  deletion  of  reports  is  requested. 

2.  Library  deletion  is  requested. 


EXPECTED  RESPONSE: 

1.  No  report  deletion  occurs. 

2.  A  performance  report  is  deleted  from  the  library, 


RESULTS : 

CASE  1 . 
CASE  2. 


-  PASS:  X  FAIL: 

-  PASS:  X  FAIL: 


DATE : 1 0  AUG  85 
DATE : 1 0  AUG  85 


REMARKS:  No  problems  encountered 
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REQUIREMENT:  5.0  -  Have  all  operating  instructions  and 
procedures  in  a  comprehensive  user's  manual. 


TEST  CASES: 

1.  Manual  represents  all  the  operating  instructions  for 
the  performance  monitor. 

EXPECTED  RESPONSE: 

1.  The  manual  is  complete  in  its  coverage  of  monitor 
operations. 


RESULTS : 

CASE  1.  -  PASS:  X  FAIL:  DATE : 1 5  SEP  85 


REMARKS:  No  problems  encountered. 
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